List Agents
Machine Agents
List Agents
List all machine agent identities for the authenticated tenant with filtering and pagination
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
RequiresX-API-Key header or Bearer JWT token. Tenant-scoped via X-Tenant-ID.
Query Parameters
string
Filter by agent type. One of:
"orchestrator", "worker", "inference",
"pipeline", "service", "bot", "llm".string
Filter by lifecycle status. One of:
"active", "suspended", "revoked".string
Filter by trust level. One of:
"platform_root", "verified_org",
"verified_individual", "authenticated", "self_asserted", "anonymous".integer
Maximum number of agents to return per page. Range: 1-200. Default:
50.integer
Number of records to skip for pagination. Default:
0.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
API key for machine-to-machine authentication
Query Parameters
Maximum number of agents to return
Required range:
1 <= x <= 100Number of agents to skip
Required range:
x >= 0Filter by agent status
Available options:
active, suspended, revoked Filter by agent type
Available options:
orchestrator, worker, inference, pipeline, service, bot, llm 
