Skip to main content
Every command accepts the same three output flags. They are global, so they are left out of the per-command flag tables in the command reference. The fourth global flag, --subdomain, picks the workspace and is covered under Authentication. If more than one is set, --toon wins over --quiet, which wins over --json.

​
Pretty output

With no flag and a terminal attached, listings render as a table and single records as a key-value block, followed by a short list of commands you are likely to want next.
Tables show at most seven columns, chosen from the scalar fields the response carries and cut to your terminal width, so treat the table as something to read rather than something to parse. Paginated listings end with a line such as Page 1 of 6 (137 total records).

​
JSON

The sample below trims the ticket fields; see tickets list for the full record.
data holds the records themselves. For a listing that is the bare array of records, with the API’s wrapper key (tickets, comments, team_members) removed; for a single record it is the object the API returned, such as {"ticket": {...}}. breadcrumbs lists the follow-up commands the pretty output would have suggested, and pagination appears on paginated listings with the same keys the API uses. The envelope is also what you get when output is piped or redirected, because the CLI drops pretty formatting when standard output is not a terminal. neetodesk tickets list > out.json therefore writes JSON without needing --json. Commands that only confirm an action, such as logout and team-members delete, print a message rather than a record. Under --json, or when piped, that is {"message": "..."}.

​
Quiet

--quiet prints the data part on its own, with no envelope, no pagination and no breadcrumbs. For a listing that is the bare array, so index into it directly:
On commands that create a record, quiet mode prints just the identifier, which makes it easy to capture:
On commands that only confirm an action, quiet mode prints success.

​
TOON

--toon emits TOON, an indentation-based encoding that carries the same data in fewer tokens than JSON. It is intended for AI assistants reading command output. A paginated listing is followed by its pagination block in the same encoding:
The listing’s header row names the columns once, then each record is one comma-separated line. The pagination block that follows uses plain key: value lines instead, with no blank line between the two. See AI assistants for how the CLI plugs into Claude, Cursor and the rest.