Skip to content

tools browser delete

Delete a headless browser.

Description

Delete a browser by id (DELETE /v1/browsers/{id}).

Deleting a browser also deletes its sessions (cascade). The CLI shows what will be deleted and asks for confirmation first: it prints the browser's id, name, status and session count (a preview + the prompt go to stderr, so -o json/-o id stdout stays parseable), then waits for y/yes.

  • --force — skip the prompt (required in non-interactive scripts: without a TTY the confirm reads EOF and aborts)
  • --dry-run — print the preview and exit without deleting anything

Synopsis

grn agentbase tools browser delete <id> [--force] [--dry-run]

Arguments

<id> (string) — browser id. Required.

Options

--force (bool) — skip the confirmation prompt.

--dry-run (bool) — preview what will be deleted without executing.

Output

  • table — nothing on stdout (the preview, prompt and confirmation line go to stderr)
  • json — {"id": "<id>"}
  • id — the deleted browser's id

Examples

# Preview the cascade without deleting
grn agentbase tools browser delete br-1a2b3c --dry-run

# Interactive (asks y/N)
grn agentbase tools browser delete br-1a2b3c

# Scripted / CI
grn agentbase tools browser delete br-1a2b3c --force

Global options

All grn agentbase commands accept:

  • -o, --output json|table|id — output format (default table)
  • -i, --interactive — prompt for missing required parameters
  • The shared grn global options: --profile, --region, --query, --endpoint-url, --debug