The tickets command lets you list, create, update, and inspect tickets, including comments and drafts.
List tickets
This command shows tickets in your workspace. Use this when you want to review open or filtered tickets without opening the Tickets page in NeetoDesk.
neetodesk tickets list
neetodesk tickets list --page 1 --page-size 10 --status openOptional flags:
--page- Page number--page-size- Items per page--status- Filter by status (comma-separated, e.g.open,pending)
--subdomain <name>- Target a specific logged-in workspace--json- Return JSON envelope output--quiet- Return raw payload only--toon- Return TOON (token-optimized) output
Sample output:
STATUS CATEGORY DESCRIPTION GROUP ID NUMBER PRIORITY
────── ──────── ──────────────────────────────────────────────── ────── ────── ────── ────────
open - <p>Need help with billing</p> - c89... 1 low
open - <p>Feature request for dashboard export</p> - ec9... 2 medium
Page 1 of 5 (10 total records)
Show: neetodesk tickets show <id>
Update: neetodesk tickets update <id>Show a ticket
This command shows details for one ticket ID. Use this when you want to inspect subject, status, priority, customer, and custom fields after finding the ticket from tickets list.
neetodesk tickets show c8926a42-0bf4-4a79-8786-affd9bf34cc1Required argument:
<id>- Ticket UUID
Optional flags:
--subdomain <name>- Target a specific logged-in workspace--json- Return JSON envelope output--quiet- Return raw payload only--toon- Return TOON (token-optimized) output
Sample output:
ID c8926a42-0bf4-4a79-8786-affd9bf34cc1
NUMBER 1
SUBJECT Billing follow-up
DESCRIPTION <p>Please review pending invoice</p>
PRIORITY low
STATUS open
CATEGORY -
SUB CATEGORY ONE -
SUB CATEGORY TWO -
GROUP -
TAGS []
CUSTOMER (4 fields)
FIELDS []
Comments: neetodesk tickets comments list <id>
Update: neetodesk tickets update <id>Create a ticket
This command creates a ticket for a customer email. Use this when you want to log a support request from the terminal.
neetodesk tickets create --email [email protected] --subject "Billing follow-up" --description "Please review pending invoice" --priority low --status openRequired flags:
--email- Customer email--subject- Ticket subject--description- Ticket description
Optional flags:
--agent-id- Agent ID to assign--assignee-email- Agent email to assign--category- Ticket category--group-id- Group ID to assign--name- Customer name--priority- Ticket priority (low,medium,high,urgent)--status- Ticket status
--subdomain <name>- Target a specific logged-in workspace--json- Return JSON envelope output--quiet- Return raw payload only--toon- Return TOON (token-optimized) output
Sample output:
ID c8926a42-0bf4-4a79-8786-affd9bf34cc1
NUMBER 42
URL https://acme.neetodesk.com/admin/tickets/42
Show: neetodesk tickets show <id>Update a ticket
This command updates fields for a ticket ID. Use this when you need to change status, priority, subject, description, or assignment from the terminal.
neetodesk tickets update c8926a42-0bf4-4a79-8786-affd9bf34cc1 --priority medium --status open --subject "Updated subject"Required argument:
<id>- Ticket UUID
Optional flags:
--agent-id- Agent ID to assign--assignee-email- Agent email to assign--category- Ticket category--description- Ticket description--group-id- Group ID to assign--priority- Ticket priority--status- Ticket status--subject- Ticket subject
--subdomain <name>- Target a specific logged-in workspace--json- Return JSON envelope output--quiet- Return raw payload only--toon- Return TOON (token-optimized) output
Sample output:
ID c8926a42-0bf4-4a79-8786-affd9bf34cc1
NUMBER 1
SUBJECT Updated subject
DESCRIPTION <p>Please review pending invoice</p>
PRIORITY medium
STATUS open
CATEGORY -
SUB CATEGORY ONE -
SUB CATEGORY TWO -
GROUP -
TAGS []
CUSTOMER (4 fields)
FIELDS []List comments on a ticket
This command shows comments on one ticket ID. Use this when you want to review the conversation history, including replies, notes, and the original description.
neetodesk tickets comments list c8926a42-0bf4-4a79-8786-affd9bf34cc1
neetodesk tickets comments list c8926a42-0bf4-4a79-8786-affd9bf34cc1 --page 1 --page-size 10Required argument:
<id>- Ticket UUID
Optional flags:
--page- Page number--page-size- Items per page
--subdomain <name>- Target a specific logged-in workspace--json- Return JSON envelope output--quiet- Return raw payload only--toon- Return TOON (token-optimized) output
Sample output:
COMMENT TYPE CONTENT CREATED AT ID
──────────── ─────────────────────────────── ─────────────────── ────────────────────────────────────
description Need help with billing 2024-10-03T10:55... 6d7f04f8-5773-4ee3-bff9-0c8a9d1e2f3a
note Internal note for docs 2026-06-24T17:47... 4ab69853-da54-45ab-ad64-1e3b6c287fbe
reply Thanks, we are looking into it 2026-06-24T17:48... 9ca920e6-0964-4209-a326-4f1a2b3c4d5e
Page 1 of 1 (3 total records)
Show: neetodesk tickets comments show <id> <comment-id>Show a comment on a ticket
This command shows details for one comment on a ticket. Use this when you want to inspect comment type, content, author, and attachments.
neetodesk tickets comments show c8926a42-0bf4-4a79-8786-affd9bf34cc1 6d7f04f8-5773-4ee3-bff9-0c8a9d1e2f3aRequired argument:
<id>- Ticket UUID<comment-id>- Comment UUID
Optional flags:
--subdomain <name>- Target a specific logged-in workspace--json- Return JSON envelope output--quiet- Return raw payload only--toon- Return TOON (token-optimized) output
Sample output:
ID 6d7f04f8-5773-4ee3-bff9-0c8a9d1e2f3a
CREATED AT 2024-10-03T10:55:28.721Z
COMMENT TYPE description
CONTENT Need help with billing
AUTHOR (4 fields)
ATTACHMENTS []Create a comment on a ticket
This command adds a reply or internal note to a ticket. Use this when you want to respond to a customer or leave a private note from the terminal.
neetodesk tickets comments create c8926a42-0bf4-4a79-8786-affd9bf34cc1 --author-email [email protected] --content "Internal note for docs" --comment-type noteRequired argument:
<id>- Ticket UUID
Required flags:
--content- Comment content (HTML)--author-email- Author email (agent or customer)
Optional flags:
--comment-type- Comment type:replyornote(defaultreply)
--subdomain <name>- Target a specific logged-in workspace--json- Return JSON envelope output--quiet- Return raw payload only--toon- Return TOON (token-optimized) output
Sample output:
ID 4ab69853-da54-45ab-ad64-1e3b6c287fbe
CREATED AT 2026-06-24T17:47:11.239Z
COMMENT TYPE note
CONTENT Internal note for docs
AUTHOR (4 fields)
ATTACHMENTS []Create or upsert a draft on a ticket
This command creates or updates a draft reply or note on a ticket. Use this when you want to save a response before sending it.
neetodesk tickets drafts create c8926a42-0bf4-4a79-8786-affd9bf34cc1 --content "Draft response for docs" --comment-type replyRequired argument:
<id>- Ticket UUID
Required flag:
--content- Draft content (HTML)
Optional flags:
--author-email- Author agent email--comment-type- Draft type:replyornote(defaultreply)
--subdomain <name>- Target a specific logged-in workspace--json- Return JSON envelope output--quiet- Return raw payload only--toon- Return TOON (token-optimized) output
Sample output:
ID 8f3e2a1b-9c4d-4e5f-a6b7-c8d9e0f1a2b3
COMMENT TYPE reply
CREATED AT 2026-06-24T17:23:58.938Z
UPDATED AT 2026-06-24T17:46:06.741Z
CONTENT Draft response for docs