Command reference

File Commands

View as Markdown

Upload, download, update, and delete durable files.

Output formatting flags (--json, --jq, and --template) are documented once in Output Formatting and are omitted from the tables below.

bctrl file list

List files

$bctrl file list [flags]
FlagDescription
--space <id>Filter by space id
--run <id>Filter by run id
--runtime <id>Filter by runtime id
--type <type...>Filter by file artifact type
--source <source>Filter by file source
--prefix <path>Filter by path prefix
--foldersDirectory view: direct files plus subfolder rollups
--created-after <iso>Only files created after this timestamp
--q <text>Search query
-L, --limit <number>Maximum number of results to return
--cursor <cursor>Pagination cursor

bctrl file get

View file metadata

$bctrl file get <fileId>

bctrl file upload

Upload a file

$bctrl file upload <path> [flags]
FlagDescription
--space <id>Space id; omitted uses caller default space
--path <storagePath>Storage path
--name <name>Display name
--metadata <json>Metadata as inline JSON

bctrl file download

Download file content

$bctrl file download <id> [flags]
FlagDescription
--to <path>Output path, or - for stdout

bctrl file patch

Edit file metadata

$bctrl file patch <fileId> [flags]
FlagDescription
--name <name>Display name
--metadata-file <path>Metadata JSON file

bctrl file delete

Delete a file

$bctrl file delete <fileId> [flags]
FlagDescription
-y, --yesConfirm deletion