Get one immutable agent version
Returns one immutable agent version by id. The version must belong to the agent in the path; a mismatch is a 404 rather than a cross-agent read.
Authorizations
A Recursion API key, created in the console under API keys.
Path Parameters
Agent id (UUID) the version belongs to.
Immutable agent version id (UUID), as listed by listAgentVersions or reported as an agent's latest_agent_version_id.
Response
An immutable snapshot of an agent's configuration, minted on every update. Sessions reference a version rather than the agent, so a running session's behaviour cannot change under it.
An immutable snapshot of an agent's configuration, minted on every update. Sessions reference a version rather than the agent, so a running session's behaviour cannot change under it.
Agent this version belongs to (UUID).
Identifier for this agent version (UUID). Server-assigned. Pass it when starting a session that must run a specific version.
RFC 3339 timestamp of when this record was created. Server-assigned.
Narrows this version's default vaults to individual credentials.
Vaults whose credentials are copied into a new session started from this version when the create request omits vault_ids.
Native integration providers whose MCP tools sessions started from this version do not receive. The grant and its sandbox credentials are unaffected.
Remote MCP servers attached at this version. Each entry is an object with name and url (http/https); further keys pass to the runtime unchanged. Credentials come from the session's granted vaults.
Default inference settings this version applies to every turn unless a session overrides them.
The agent's human-readable label as it stood at this version.
Organization that owns this record. Resolved from the API key; never accepted from the caller.
Skill packages loaded into the runtime at this version, each an entry with the skill reference and its metadata.
System prompt this version prepends to every conversation.
The bare evaluation marker, when this is an evaluator version. Historical stored versions may contain ignored declarations, omitted from current API responses. Built-in sandbox tools need no marker.
1Monotonically increasing version counter within the agent, starting at 1. Server-assigned.
Built-in integrations sessions started from this version may use, each naming an organization connection an admin added. Snapshotted with the version.
User who made the edit that produced this version, for audit. Empty when the version was created by an automated caller.
Markdown rubric that sessions started from this version are graded against when their create request omits an outcome. A session that supplies its own outcome ignores this entirely.
The agent's free-text note as it stood at this version.
Maximum concurrent root sessions configured on the agent when this version was minted. Unset means unlimited. Live admission uses the agent head's current value, not this snapshot.
1 <= x <= 10000Free-form caller-supplied key/value labels. Stored verbatim and never interpreted by the service.
Model this version runs on, in the same form as an agent's model: a models-catalog id such as anthropic/claude-sonnet-4-5, returned in its stored form with a provider prefix added.
Multi-agent orchestration settings at this version, such as subagent definitions and delegation limits.
Native connections this agent may use, with provider-enforced permission and resource restrictions. Omit or send [] for none. Stored in full on each agent version; secrets remain on the connection.
25Whether sessions created from this version may use the native web_search tool. Omitted on legacy versions and interpreted as enabled.