Sureva CLI
The sureva CLI lets you manage Sureva Cloud resources from your terminal or automation scripts. All commands output JSON by default, making it easy to pipe results into other tools.
Quick path
Section titled “Quick path”- Install the CLI — download a binary from GitHub Releases or use
go install. - Create a personal access token:
sureva auth token create --name my-token --expires-at 2026-12-31T00:00:00Z - Export the token:
export SUREVA_TOKEN=sapi_<your-token> - Verify authentication:
sureva auth whoami - List your organizations:
sureva orgs list
JSON-first output
Section titled “JSON-first output”The CLI outputs JSON by default (--output json). Use --output table for human-readable terminal output. In scripts and agents, rely on the JSON output — its structure is stable and machine-parseable.
sureva apps list --org my-org --output jsonsureva deploys list my-app-id --org my-org | jq '.[0].status'Pages in this section
Section titled “Pages in this section”| Page | What it covers |
|---|---|
| Installation | GitHub Releases binaries and go install |
| Authentication | Personal access tokens, environment variables, config file |
| Reference | All 17 commands, global flags, and exit codes |
| Agent usage | JSON output patterns and scripting for AI agents |