> ## Documentation Index > Fetch the complete documentation index at: https://apidocs.neetodesk.com/llms.txt > Use this file to discover all available pages before exploring further. # tickets > List, read, create and update tickets, and manage their comments and drafts. Tickets are the central work item in NeetoDesk. For fields and response details, see the [API reference](/api-reference/tickets/list). Sample output on this page is shown as the `--json` envelope, which is reproducible. Pretty tables depend on your terminal width. See [Output formats](/cli/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. ```bash theme={"system"} neetodesk tickets list --status open,pending --page-size 25 ``` | Flag | Type | Required | 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) | ```json theme={"system"} { "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. ```bash theme={"system"} neetodesk tickets show 1042 ``` ### Required arguments * `` - 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. ```bash theme={"system"} 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 | Default | 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. ```bash theme={"system"} neetodesk tickets update 1042 --status resolved --priority low ``` ### Required arguments * `` - the ticket's number or UUID. | Flag | Type | Required | Default | 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. ```bash theme={"system"} neetodesk tickets comments list 1042 ``` ### Required arguments * `` - 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) | ```json theme={"system"} { "data": { "comments": [ { "id": "3a9d7e21-4b8c-4d15-9e73-6f2a1b0c8d94", "comment_type": "reply", "content": "

We have issued the refund.

", "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. ```bash theme={"system"} neetodesk tickets comments show 1042 3a9d7e21-4b8c-4d15-9e73-6f2a1b0c8d94 ``` ### Required arguments * `` - the ticket's number or UUID. * `` - 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. ```bash theme={"system"} neetodesk tickets comments create 1042 \ --content "

We have issued the refund.

" \ --comment-type reply ``` ### Required arguments * `` - 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. ```bash theme={"system"} neetodesk tickets drafts create 1042 \ --content "

Checking with the payments team.

" \ --author-email oliver.smith@example.com ``` ### Required arguments * `` - 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) |