doctl adds GradientAI simulation APIs
Introduced 2026-08-31 · score 0.95
HOW TO USE IT
When working with GradientAI scenarios or simulations in doctl v1.168.0, choose the command for the operation: use `scenario-set` to manage scenario sets and `simulation-run` to run or inspect simulations.
doctl gradient scenario-set list --statuses readydoctl gradient simulation-run list --statuses runningdoctl gradient simulation-run get <run-uuid> -o jsonWHY THIS HELPS
When working with GradientAI scenarios or simulations through doctl, inspect the added simulation API commands and use the command that matches the operation you need.
REQUIREMENTS AND LIMITATIONS
- Version: v1.168.0
- `<run-uuid>` (required): UUID of the simulation run to retrieve.
- `--statuses`: Filters runs by status; documented values include `running`.
- `-o json`: Selects JSON output; the get command documentation says this also shows per-scenario results.
- Prerequisite: Authenticate doctl with a DigitalOcean API V2 access token; the command reference lists `--access-token` / `-t` as a global flag.
FIRST-PARTY EVIDENCE
- https://github.com/digitalocean/doctl/releases/tag/v1.168.0
- https://github.com/digitalocean/doctl/pull/1937
- https://docs.digitalocean.com/reference/doctl/reference/gradient/scenario-set/list/
- https://docs.digitalocean.com/reference/doctl/reference/gradient/simulation-run/list/
- https://docs.digitalocean.com/reference/doctl/reference/gradient/simulation-run/get/
Check the installed version and the source before using it. Entry JSON