Skip to main content
GET
List Agents

List Agents

GET /v1/agents Returns a paginated list of all machine agent identities registered under the authenticated tenant. Results can be filtered by agent type, status, and trust level. Agents are returned in reverse chronological order (newest first).

Authentication

Requires X-API-Key header or Bearer JWT token. The workspace is derived from the authenticated credential; do not send X-Tenant-ID.

Response

object[]
Array of agent identity objects. Each object contains the full agent record including agent_id, agent_type, display_name, status, trust_level, trust_score, scopes, public_key, key_id, metadata, delegation_depth, created_at, and updated_at.
integer
Total count of agents matching the filter criteria, across all pages.

Example

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Query Parameters

agent_type
enum<string>

Filter by agent type

Available options:
orchestrator,
worker,
inference,
pipeline,
service,
bot,
llm
status
enum<string>

Filter by agent status

Available options:
active,
suspended,
revoked
trust_level
string
limit
integer

Maximum number of agents to return

Required range: 1 <= x <= 100
offset
integer

Number of agents to skip

Required range: x >= 0

Response

Paginated list of agents

items
object[]
total
integer