Skip to main content
GET
List an agent's immutable version history

Authorizations

Authorization
string
header
required

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

Path Parameters

agent_id
string<uuid>
required

Agent id (UUID) as returned by createAgent or listAgents.

Response

Response body of GET /v1/agents/{agent_id}/versions. Scoped to the one agent in the path, so an empty list means that agent has no versions yet, not that no agents exist. Versions are immutable snapshots: pin one to make a session reproducible.

Response body of GET /v1/agents/{agent_id}/versions. Scoped to the one agent in the path, so an empty list means that agent has no versions yet, not that no agents exist. Versions are immutable snapshots: pin one to make a session reproducible.

agent_versions
object[] | null
required

Every published version of the requested agent, newest first. Null rather than an empty array when the agent exists but has never been versioned.