Skip to main content
GET
List agents

Authorizations

Authorization
string
header
required

A Recursion API key, created in the console under API keys.

Query Parameters

tag_ids
string

Comma-separated tag ids, with at most 32 distinct ids. Blank segments are ignored. An agent must carry every requested tag (AND semantics). Unknown or cross-organization ids return 404.

Response

Response body of GET /v1/agents. Unpaginated: the whole organization is returned in one document, so callers need no cursor here. Each row is the agent's current mutable definition; its immutable snapshots are listed by GET /v1/agents/{agent_id}/versions.

Response body of GET /v1/agents. Unpaginated: the whole organization is returned in one document, so callers need no cursor here. Each row is the agent's current mutable definition; its immutable snapshots are listed by GET /v1/agents/{agent_id}/versions.

agents
object[] | null
required

Every agent in the caller's organization, newest first. Null rather than an empty array when the organization has no agents. Soft-deleted agents are omitted.