Skip to content

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:

Terminal window
dexto cloud api GET /v1/agents

Generated from dexto 2.0.0-beta.0.

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.