Output formats

Every command accepts the same four output flags. They are global, so they are left out of the per-command flag tables in the command reference.

Flag	Output
(none)	A pretty table or record, plus suggested follow-up commands
`--json`	A JSON envelope with `data`, and `pagination` and `breadcrumbs` where they apply
`--quiet`	The raw response body only, with no envelope
`--toon`	TOON, a compact encoding aimed at AI agents

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.

neetodesk tickets list

Column choice depends on the fields the response carries and on your terminal width, so treat the table as something to read rather than something to parse.

JSON

neetodesk tickets list --json

{
  "data": {
    "tickets": [
      {
        "id": "0f1e4c9a-6d3b-4f92-8a71-25b0c8d4e6f3",
        "number": 1042,
        "subject": "Refund not received",
        "status": "open",
        "priority": "high",
        "category": "Billing",
        "created_at": "2026-08-03T09:14:22.000Z"
      }
    ]
  },
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total_count": 137
  },
  "breadcrumbs": [
    { "label": "Show", "command": "neetodesk tickets show <id>" }
  ]
}

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.

Quiet

--quiet prints the response body on its own, with no envelope, no pagination and no breadcrumbs:

neetodesk tickets list --quiet | jq '.tickets[].number'

On commands that create or update a record, quiet mode prints just the identifier, which makes it easy to capture:

ticket_id=$(neetodesk tickets create \
  --email customer@example.com \
  --subject "Refund not received" \
  --description "Card was charged twice." \
  --quiet)

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:

neetodesk tickets list --toon

See AI assistants for how the CLI plugs into Claude, Cursor and the rest.

Getting Started

Commands

Pretty output

JSON

Quiet

TOON

​Pretty output

​JSON

​Quiet

​TOON

Pretty output

JSON

Quiet

TOON