Skip to main content

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).

Required scope: support:read

Grant 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_bot is true when it is the AI agent. name is 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-over
  • stage (string) — one of: received, investigating, fixing, waiting_on_you, resolved (a ticket SKU.io Support has started on reads investigating — the customer is never told it was picked up, or by whom); stage_label (string) — the agent-facing label
  • phase (string, nullable) — the owner's own working phase from its last heartbeat (e.g. running, awaiting_human); cleared on every claim, release and hand-back
  • working_now (boolean) — true while active_until is in the future; active_until (ISO-8601, nullable) — when the last heartbeat runs out
  • progress_text (string, nullable, max 280) and progress_at (ISO-8601, nullable) — the latest progress line the customer sees
  • stale (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; always null in 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) — a key from the categories list (a SKU.io feature, platform.other or none); null while uncategorised. feature_label is its display name
  • area / area_label (string, nullable) — the product area of that feature (null for none or while uncategorised)
  • cause (string, nullable) — one of: how_to, configuration, defect, third_party, request, billing, data_process, other. cause_label is its display name
  • source (string, nullable) — who set it: ai (suggested automatically when the ticket was triaged), customer (someone on the account) or agent (SKU.io Support); source_label is the same in customer wording
  • suspected_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 defect
  • locked (boolean) — true once SKU.io Support set the category; the customer can no longer change it
  • set_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​

OK

Response Headers
    Content-Type