Skip to main content

List AI Runners

GET 
/api/support/agent/ai/runners

The AI routing settings page. me is the caller's own runner (unsaved defaults — on, assigned + unassigned — when they have never saved settings). runners is every runner on the team for a support admin, and just the caller's own (once saved) for anyone else.

Required scope: support:read

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

Runner fields

  • id (integer|null) — null for a person who has never saved settings (the defaults are shown)
  • owner ({id, name, email}|null) — the person the runner works for; null = the team runner
  • bot ({id, name}|null) — the runner's own account (its token); null until a token is minted for this person
  • is_mine (boolean) — the caller's own runner
  • enabled (boolean) — off = takes no new tickets (keeps the ones it holds)
  • scope (assigned_and_unassigned | assigned_only) and scope_label
  • online (boolean) — heartbeat within the last 5 minutes
  • available (boolean) — online, enabled, has a token and is not paused on its machine
  • accepting (boolean) — false while the runner reported itself paused
  • last_seen_at, version, host, running [{ticket_id, phase, started_at}], queue_size
  • host_conflict ({host, at}|null) — a second machine used this runner's token while it was online, within the last day
  • updated_at

Authentication: Bearer token with the support:read scope on a support agent account. No tenant context — this endpoint is central.

Request​

Responses​

OK

Response Headers
    Content-Type