Skip to main content

Get AI Agent Status

GET 
/api/support/agent/ai/status

The AI agent's overall state: whether all AI work is paused, and what the AI agent's runner last reported.

Required scope: support:read

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

Response data

  • paused (boolean) — all AI work is paused
  • paused_by ({id, name}, nullable)
  • paused_at (ISO 8601, nullable)
  • reason (string, nullable) — why it was paused
  • runner (object, nullable — null until the runner has checked in once): last_seen_at (ISO 8601), version (string, nullable), host (string, nullable), running (array of {ticket_id, phase, started_at} — the sessions it is running), queue_size (integer — tickets waiting in its local queue)
  • online (boolean) — the runner checked in within the last 5 minutes

Changes are also pushed on the private support.agents channel as support.ai.changed ({kind: settings|runner, paused, online, changed_at}) — refetch this endpoint when one arrives.

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

Request​

Responses​

OK

Response Headers
    Content-Type