Skip to main content
GET
List agents in organization

Authorizations

Authorization
string
header
required

Supabase JWT token in Authorization: Bearer header

Path Parameters

org_id
string
required

Organization identifier (e.g. org-abc12345)

Query Parameters

mine
boolean
default:false

Filter to only current user's agents

limit
integer
default:50

Opt-in pagination: max agents to return. Omit limit AND offset for the full (unpaginated) listing. When supplied, the response adds total/limit/offset.

Required range: 1 <= x <= 500
offset
integer
default:0

Opt-in pagination: number of agents to skip.

Required range: x >= 0
groupId
string

Filter the fleet by agent group. A group <uuid> returns only that group's members; the literal ungrouped returns only agents in no active group. A foreign-org or unknown id returns an empty page (indistinguishable from a missing id — no existence leak). The filter is applied before pagination, so total reflects it. Has NO effect when scope=archived (archived rows do not carry group data).

Response

Organization agents. Includes total/limit/offset only when limit or offset was supplied.

agents
object[]
required
total
integer

Total agents before pagination (present only when paginating).

limit
integer

Echoed page size (paginated only).

offset
integer

Echoed offset (paginated only).