If more than one is set, the precedence is
--toon, then --quiet, then
--json, then pretty.
Pretty
The default on a terminal. Arrays render as tables, single records as key-value blocks, and list commands print a pagination summary and breadcrumbs to related commands underneath.Tables show at most seven columns, chosen from the fields the API returned and
trimmed to your terminal width. Which columns appear is therefore not stable
across resources or terminals. Use
--json for anything you intend to parse,
which is the format every sample in the command reference
uses.JSON envelope
Used automatically when output is piped or redirected, and forced with--json.
The payload is wrapped in an envelope:
data holds the resource body. breadcrumbs is omitted when there are none,
and pagination appears only on list commands.
Quiet
--quiet drops the envelope and prints the payload alone, which is what you
want inside a script:
team-members create returns a message rather than the new records, so --quiet prints
{"message":"Users added successfully"}; team-members update prints the full
updated record; delete prints success. To capture a member’s id, list by
email instead:
TOON
--toon emits TOON, which carries the same data as JSON with the repeated keys
factored out. It is meant for handing results to an AI assistant, where it costs
noticeably fewer tokens than the equivalent JSON.
Pagination
List commands take--page (1-indexed; omit it for the first page) and
--page-size (maximum 100). The envelope’s pagination block reports
current_page_number, total_pages, total_records and page_size, so a
script can walk every page by incrementing --page until it reaches
total_pages.