tickets

Tickets are the central work item in NeetoDesk. For fields and response details, see the API reference.

Sample output on this page is shown as the --json envelope, which is reproducible. Pretty tables depend on your terminal width. See Output formats.

Everywhere a ticket ID is taken, the CLI accepts either the ticket’s UUID or its workspace-scoped number, so neetodesk tickets show 1042 and neetodesk tickets show 0f1e4c9a-6d3b-4f92-8a71-25b0c8d4e6f3 do the same thing. The number is the one shown in the web app, and is usually the easier of the two to type.

tickets list

Lists the tickets you can access, newest first. Use it to triage a queue, or narrow it to the statuses you care about.

neetodesk tickets list --status open,pending --page-size 25

Flag	Type	Default	Description
`--page`	`int`	`0`	Page number
`--page-size`	`int`	`0`	Items per page (max 100)
`--status`	`string`		Filter by status (comma-separated, e.g. open,pending)

{
  "data": {
    "tickets": [
      {
        "id": "0f1e4c9a-6d3b-4f92-8a71-25b0c8d4e6f3",
        "number": 1042,
        "subject": "Refund not received",
        "status": "open",
        "priority": "high",
        "category": "Billing",
        "group": "Payments",
        "tags": ["refund"],
        "created_at": "2026-08-03T09:14:22.000Z",
        "assignee": {
          "id": "7b2c1d40-5e6f-4a81-9c23-0d4e5f6a7b8c",
          "name": "Oliver Smith",
          "email": "oliver.smith@example.com"
        }
      }
    ]
  },
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total_count": 137
  }
}

tickets show

Returns one ticket in full, including its description and the agent, customer, group and tags it is associated with.

neetodesk tickets show 1042

Required arguments

<id> - the ticket’s number or UUID.

tickets create

Opens a ticket on behalf of a customer, identified by their email address. The description becomes the ticket’s first comment. If no customer with that email exists, one is created.

neetodesk tickets create \
  --email customer@example.com \
  --subject "Refund not received" \
  --description "The card was charged twice on 2 August." \
  --priority high \
  --assignee-email oliver.smith@example.com

Flag	Type	Required	Description
`--agent-id`	`string`		Agent ID to assign
`--assignee-email`	`string`		Agent email to assign
`--category`	`string`		Ticket category
`--description`	`string`	Yes	Ticket description
`--email`	`string`	Yes	Customer email
`--group-id`	`string`		Group ID to assign
`--name`	`string`		Customer name
`--priority`	`string`		Ticket priority (low, medium, high, urgent)
`--status`	`string`		Ticket status
`--subject`	`string`	Yes	Ticket subject

tickets update

Changes a ticket’s subject, description, status, priority, category, assignee or group. Pass only the flags you want to change; the rest are left as they are.

neetodesk tickets update 1042 --status resolved --priority low

Required arguments

<id> - the ticket’s number or UUID.

Flag	Type	Description
`--agent-id`	`string`	Agent ID to assign
`--assignee-email`	`string`	Agent email to assign
`--category`	`string`	Ticket category
`--description`	`string`	Ticket description
`--group-id`	`string`	Group ID to assign
`--priority`	`string`	Ticket priority
`--status`	`string`	Ticket status
`--subject`	`string`	Ticket subject

tickets comments list

Lists a ticket’s comments in the order they were added, each with its type, author and body.

neetodesk tickets comments list 1042

Required arguments

<ticket-id> - the ticket’s number or UUID.

Flag	Type	Required	Default	Description
`--page`	`int`		`0`	Page number
`--page-size`	`int`		`0`	Items per page (max 100)

{
  "data": {
    "comments": [
      {
        "id": "3a9d7e21-4b8c-4d15-9e73-6f2a1b0c8d94",
        "comment_type": "reply",
        "content": "<p>We have issued the refund.</p>",
        "created_at": "2026-08-03T11:02:41.000Z",
        "author": {
          "id": "7b2c1d40-5e6f-4a81-9c23-0d4e5f6a7b8c",
          "name": "Oliver Smith",
          "email": "oliver.smith@example.com",
          "type": "agent"
        },
        "attachments": []
      }
    ]
  }
}

tickets comments show

Returns one comment on a ticket.

neetodesk tickets comments show 1042 3a9d7e21-4b8c-4d15-9e73-6f2a1b0c8d94

Required arguments

<ticket-id> - the ticket’s number or UUID.
<comment-id> - the comment’s UUID.

tickets comments create

Adds a comment to a ticket. A reply is published on the ticket where the customer reads it; a note stays internal to the workspace.

neetodesk tickets comments create 1042 \
  --content "<p>We have issued the refund.</p>" \
  --comment-type reply

Required arguments

<ticket-id> - the ticket’s number or UUID.

Flag	Type	Required	Default	Description
`--author-email`	`string`			Author email (agent or customer)
`--comment-type`	`string`		`reply`	Comment type: reply or note
`--content`	`string`	Yes		Comment content (HTML)

tickets drafts create

Saves an unsent draft on a ticket, replacing whichever draft the ticket already holds of that type. A reply drafted for an agent gets that agent’s saved signature appended.

neetodesk tickets drafts create 1042 \
  --content "<p>Checking with the payments team.</p>" \
  --author-email oliver.smith@example.com

Required arguments

<ticket-id> - the ticket’s number or UUID.

Flag	Type	Required	Default	Description
`--author-email`	`string`			Author agent email
`--comment-type`	`string`		`reply`	Draft type: reply or note
`--content`	`string`	Yes		Draft content (HTML)

Getting Started

Commands

tickets list

tickets show

Required arguments

tickets create

tickets update

Required arguments

tickets comments list

Required arguments

tickets comments show

Required arguments

tickets comments create

Required arguments

tickets drafts create

Required arguments

​tickets list

​tickets show

​Required arguments

​tickets create

​tickets update

​Required arguments

​tickets comments list

​Required arguments

​tickets comments show

​Required arguments

​tickets comments create

​Required arguments

​tickets drafts create

​Required arguments

tickets list

tickets show

Required arguments

tickets create

tickets update

Required arguments

tickets comments list

Required arguments

tickets comments show

Required arguments

tickets comments create

Required arguments

tickets drafts create

Required arguments