Get Agent Ticket
GET/api/support/agent/tickets/:ticket
Returns one ticket for the agent console: everything a customer sees, plus the internal fields and every link (including agent-only kinds like a bug tracker reference).
support:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
The agent view adds group_key, external_ref, note_count, merged_into_ticket_id, sla_policy_id, created_by_user_id, sla_paused_at, snoozed_until (with is_snoozed, true while that moment is still in the future), follow_up_at (the agent's own reminder, or null), triaged_at with triaged_by_user_id (when an agent first took the ticket on, and who — null while it is still waiting to be triaged), important_to_customer (the tenant flagged this ticket as mattering to them), the agent-facing status_label, the assignee's email, and ai — the latest completed triage and draft runs. first_response_sla_status and resolution_sla_status report the ticket's two SLA clocks: one of on_track, breaching_soon (past the policy's warning point, by default 75% of the way from creation to the due date), breached, paused (the ticket is waiting on the customer, so neither clock warns), met (responded / resolved before the due date). merged_into is {id, number} once the ticket has been merged into another, otherwise null.
work — who is working the ticket and how far along it is (null only on a ticket raised before work tracking existed):
owner({user_id, name, is_bot}, nullable) — the single agent who holds the ticket;is_botis true when it is the AI agent.nameis the seat's display name.picked_up_at(ISO-8601, nullable),picked_up_by_user_id(integer, nullable) — the first claim; they never move after that, even on a take-overstage(string) — one of: received, investigating, fixing, waiting_on_you, resolved (a ticket SKU.io Support has started on readsinvestigating— the customer is never told it was picked up, or by whom);stage_label(string) — the agent-facing labelphase(string, nullable) — the owner's own working phase from its last heartbeat (e.g.running,awaiting_human); cleared on every claim, release and hand-backworking_now(boolean) — true whileactive_untilis in the future;active_until(ISO-8601, nullable) — when the last heartbeat runs outprogress_text(string, nullable, max 280) andprogress_at(ISO-8601, nullable) — the latest progress line the customer seesstale(boolean) — the AI agent owns an unresolved ticket and has shown no sign of life (heartbeat, progress or claim) for 4 hours. After 24 hours the claim is released automatically and the ticket returns to the unassigned queue.pending_approval({id, kind, version, state}, nullable) — the approval card waiting on a human decision (see the Approvals folder)hand_back({instruction, by_user_id, at}, nullable) — the latest hand-back to the AI agent. Returned on the single-ticket responses; alwaysnullin queue rows.ai_paused(boolean) — a human paused the AI agent on this ticket; it keeps its claim but does no work until resumed.ai_paused_by({id, name}, nullable) — who paused it.ai_paused_at(ISO 8601, nullable) — when it was paused.ai_disabled(boolean) — the AI agent is turned off for this ticket and never claims or acts on it.stop_requested_at(ISO 8601, nullable) — a human asked the AI agent to stop its running session; cleared when the agent confirms the session is gone.stop_requested_by({id, name}, nullable) — who asked for the stop.pending_instructions(integer) — instructions sent to the AI agent that it has not picked up yet.
ai also carries the AI agent's latest autopilot run: run_number, started_at, finished_at, cost_usd and outcome are filled on those runs and null on triage and draft runs.
category — what the ticket is about and why it was raised:
feature_key(string, nullable) — akeyfrom the categories list (a SKU.io feature,platform.otherornone); null while uncategorised.feature_labelis its display namearea/area_label(string, nullable) — the product area of that feature (null fornoneor while uncategorised)cause(string, nullable) — one of: how_to, configuration, defect, third_party, request, billing, data_process, other.cause_labelis its display namesource(string, nullable) — who set it:ai(suggested automatically when the ticket was triaged),customer(someone on the account) oragent(SKU.io Support);source_labelis the same in customer wordingsuspected_defect(boolean) — an automatic check suspected a bug that nobody has confirmed yet. It is never counted as a defect; only SKU.io Support (or an engineering link) makes a ticket a defectlocked(boolean) — true once SKU.io Support set the category; the customer can no longer change itset_at(ISO-8601, nullable) — when it was last set
Authentication: Bearer token with the support:read scope, or an authenticated session, from a caller with an active support role.
environment says which SKU.io environment the ticket was raised on — production, or beta, demo or dev for one forwarded here by that environment's intake. origin_tenant_id and origin_host are the tenant and host it came from, and are null on a ticket raised in production.
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthorized
Response Headers
Forbidden
Response Headers
Not Found
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.