Search, fetch, API and data deletion
Search the web, read pages, call any /v1 path, and delete end-user data.These commands follow the output contract: JSON when stdout is not a terminal, failures as JSON on stderr, and exit codes 0 to 6.
dexto cloud api calls any /v1 path with your credentials and prints the response, for anything the
other commands do not cover:
dexto cloud api GET /v1/agentsGenerated from dexto 2.0.0-beta.0.
dexto cloud search
Search the web.
dexto cloud search <query...> | Option | What it does |
|---|---|
--num <num> | How many results (default 10). |
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 fetch
Read up to 10 web pages as text.
dexto cloud fetch <url...> | Option | What it does |
|---|---|
--max-chars <max-chars> | Text characters per page, 100 to 100000 (default 20000). |
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 data-deletions create
Delete an end user's sessions (--user, optionally of one --agent), or all of an agent's data (--agent).
dexto cloud data-deletions create | Option | What it does |
|---|---|
--agent <agent> | The agent whose data to delete. |
--user <user> | The end-user label whose sessions to delete. |
--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.
dexto cloud data-deletions list
List data deletions.
dexto cloud data-deletions 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 data-deletions get
Show a data deletion and what it deleted.
dexto cloud data-deletions get <data_deletion_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 api
Call a /v1 path, such as: dexto cloud api GET /v1/agents. Prints the response body.
dexto cloud api <method> <path> | Option | What it does |
|---|---|
--data <data> | The request body as JSON. |
--file <file> | Read the request body from a JSON file, or - for stdin. |
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. |