Skip to content

Cloud secrets

Create and manage secrets that agents and sandboxes use without ever seeing the value.

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

Values are never shown after you create them. Pass a value on stdin so it does not land in your shell history or in an agent’s transcript:

Terminal window
printf %s "$VALUE" | dexto cloud secrets create <name> --host api.example.com

Generated from dexto 2.0.0-beta.0.

dexto cloud secrets list

List the project's secrets. Values are never shown.

dexto cloud secrets list
Option What it does
--after <after> Start after this cursor, from the previous page.
--limit <limit> How many to return.

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 secrets get

Show a secret, without its value.

dexto cloud secrets get <secret_id>

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 secrets create

Create a secret. Type the value when asked, or pipe it on stdin; it is never an argument.

dexto cloud secrets create <name>
Option What it does
--header <header> Send the value in this header instead of Authorization: Bearer.
--host <host> … A public hostname the value may be sent to; repeat for more.
--prefix <prefix> Text before the value in --header, such as 'Token '.

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 secrets update

Change a secret's hosts, placement or value.

dexto cloud secrets update <secret_id>
Option What it does
--header <header> Send the value in this header instead of Authorization: Bearer.
--host <host> … A public hostname the value may be sent to; repeat for more.
--prefix <prefix> Text before the value in --header, such as 'Token '.
--value Replace the value: type it when asked, or pipe it.

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 secrets delete

Delete a secret. Refused while an active agent uses it.

dexto cloud secrets delete <secret_id>
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.