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:
printf %s "$VALUE" | dexto cloud secrets create <name> --host api.example.comGenerated 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. |