Skip to main content

Queue counts

GET 

/api/support/agent/queue-counts

The numbers on the console's queue tabs and the sidebar badges: how many tickets sit in each queue for the calling agent right now, plus the size of the inbound-mail quarantine. Counted with the queues' own definitions and no filters, so unassigned: 6 is exactly the six rows the Unassigned tab shows.

Required scope: support:read

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

Response data:

  • queues (object) — one integer per queue: open (every unresolved ticket), unassigned, mine (assigned to the caller), triage (unassigned and untriaged), waiting, awaiting_release, breaching, snoozed, resolved, all (any status), mentioned (resolved tickets where the caller was @mentioned in a note), trash (deleted tickets still restorable), needs_you (an approval card is waiting on a human decision), ai_working (owned by the AI agent), stale (owned by the AI agent with no sign of life for 4 hours or more), ai_paused (owned by the AI agent and paused by a human).
  • inbound_mail (integer) — mails on the quarantine list.

Authentication: Bearer token with the support:read scope, or an authenticated session; the caller must hold an active support agent seat. Central — no tenant header.

Request​

Responses​

OK

Response Headers
    Content-Type