Skip to main content
Every command can return one of four output formats. In an interactive terminal, pretty output is the default. Use the flags below for machine-readable output. If more than one is set, precedence is --toon > --quiet > --json > pretty. --verbose changes pretty output only, so it has no effect alongside the other three.

​
Global flags

These flags work on every command: --subdomain selects the signed-in workspace a command targets. See Authentication.

​
Pretty

The default in a terminal: tables for lists and key-value pairs for a single record. It is intended for people, not scripts. A table shows at most seven columns. The CLI picks identifier and name fields first (id, test_entity_id, run_id, project_id, name, status, and similar), fills the remaining columns alphabetically, and keeps any URL fields as the last columns without truncating them.

​
Verbose

--verbose prints every field of every record instead of a table, one label per line, with nested objects and lists indented underneath. Use it when a table leaves out a field you need.

​
JSON

JSON wraps the resource body with breadcrumbs and, for list commands, pagination details:
For list commands, data is the array of records; the CLI removes the API response’s resource key. For show, data holds the API response body. breadcrumbs is omitted when empty, and pagination appears only on list commands. The CLI automatically uses JSON when output is piped (a non-TTY); use --json to force it.

​
Quiet

--quiet returns only the data payload, with no envelope, breadcrumbs, or pagination. This is useful in scripts:

​
TOON

--toon encodes the same data as TOON (Token-Optimized Output Notation). It keeps the JSON shape while compressing whitespace and keys, typically using 30-60% fewer tokens. Use it when giving list or show output to an AI assistant.

​
Pagination

List commands return results in pages. The flags below control paging, and the JSON envelope’s pagination block shows your position in the result set.

​
Pagination parameters

​
integer
The page of results to retrieve, starting from 1.
​
integer
The number of records to return per page. The maximum depends on the command; see Default behavior.

​
Example usage

This returns the second page of tests in the run, with 50 records per page.

​
Response structure

For list commands the JSON envelope carries a pagination block alongside the data:
​
integer
The total number of records across all pages.
​
integer
The total number of pages available.
​
integer
The page you are currently on.
​
integer
The number of records returned per page.

​
Default behavior

If you omit both flags, the CLI lets the server use its defaults: page 1, with a page size that depends on the command. Either flag overrides the defaults. A --page-size above the maximum prints a warning on standard error, and the server returns at most the maximum:
result-histories list, traces list, and top-errors list are not paginated. Their responses are bounded by the look-back window, the run, and a cap of 20 error groups respectively.

​
Best practices

  • To retrieve every page, increment --page until current_page_number == total_pages.
  • Use --json or --toon in scripts when you need the pagination block. --quiet removes the envelope, so it does not include pagination metadata.
  • Check total_records before you begin to estimate the work involved.