Skip to content

Cloud files

Upload, download, share and delete files in the Cloud project.

These commands follow the output contract: JSON when stdout is not a terminal, failures as JSON on stderr, and exit codes 0 to 6.

Files are addressed by id or by path. url makes a link anyone can read until it expires. delete needs --yes.

Generated from dexto 2.0.0-beta.0.

dexto cloud files list

List the project's files.

dexto cloud files list
Option What it does
--after <after> Start after this cursor, from the previous page.
--limit <limit> How many to return.
--contains <contains> Only paths containing this text.
--prefix <prefix> Only paths starting with this, such as reports/.

JSON when stdout is not a terminal, failures as JSON on stderr, exit codes 0 to 6. Also takes the shared options below.

dexto cloud files get

Show a file by id or path.

dexto cloud files get <file>

JSON when stdout is not a terminal, failures as JSON on stderr, exit codes 0 to 6. Also takes the shared options below.

dexto cloud files upload

Upload a local file to a project path (default: its file name).

dexto cloud files upload <local_path> [path]
Option What it does
--content-type <content-type> The media type (default from the extension).
--expires-at <expires-at> Delete the file at this ISO 8601 time.
--overwrite Replace a file already at the path.

JSON when stdout is not a terminal, failures as JSON on stderr, exit codes 0 to 6. Also takes the shared options below.

dexto cloud files download

Download a file by id or path to a local path (default: its file name), or - for stdout.

dexto cloud files download <file> [local_path]

JSON when stdout is not a terminal, failures as JSON on stderr, exit codes 0 to 6. Also takes the shared options below.

dexto cloud files url

Create a URL anyone can read the file from until it expires.

dexto cloud files url <file>
Option What it does
--expires-in <expires-in> Seconds the URL works, up to 86400 (default 3600).

JSON when stdout is not a terminal, failures as JSON on stderr, exit codes 0 to 6. Also takes the shared options below.

dexto cloud files delete

Delete a file by id or path.

dexto cloud files delete <file>
Option What it does
--yes Go ahead without being asked. Pass it only once your person has agreed.

JSON when stdout is not a terminal, failures as JSON on stderr, exit codes 0 to 6. Also takes the shared options below.

Shared options

Commands on this page that follow the JSON contract take these.

Option What it does
--api-base-url <api-base-url> The API origin (default https://api.dexto.ai, or DEXTO_API_BASE_URL).
--api-key <api-key> Use this key instead of DEXTO_API_KEY or the saved sign-in.
--profile <profile> The saved sign-in to use for this run (or DEXTO_PROFILE); see dexto accounts list.
--project <project> The Cloud project to act in when you're signed in (or DEXTO_CLOUD_PROJECT).
--json Print JSON, failures included (on stderr). The default when stdout isn't a terminal.
--table Print tables for people even when stdout isn't a terminal.