Skip to main content

List Ticket Drafts

GET 
/api/support/agent/drafts

Lists every ticket that currently holds an unsent shared draft, most recently saved first — one call, so a queue can mark the tickets somebody is already writing on without asking ticket by ticket.

Required scope: support:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

No parameters.

Response fields (data[])

  • id (integer) — the draft id
  • ticket_id (integer) — the ticket the draft belongs to
  • mode (string) — reply (a public reply) or note (an internal note)
  • body (string) — the unsent text
  • cc[] (array of strings) — the addresses the reply would copy
  • status_after (string, nullable) — the status the sender intends to set when the draft is sent
  • attachments[] — file metadata only, each {name, size}; the files themselves are uploaded with the send, so a restored draft names what was attached without still holding it
  • version (integer) — the token a save must carry, see Save Ticket Draft
  • user ({id, name}) — the agent who holds the draft right now
  • created_at, updated_at (ISO-8601)

Authentication: Bearer token with the support:read scope, or an authenticated session, from a caller with an active support role. No tenant context — this endpoint is central.

Request​

Responses​

OK

Response Headers
    Content-Type