Skip to main content
GET
Get one immutable agent version

Authorizations

Authorization
string
header
required

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

Headers

x-tenant-id
string

Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.

Minimum string length: 1
x-organization-id
string

Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.

Minimum string length: 1

Path Parameters

agentId
string<uuid>
required

Agent id (UUID) the version belongs to.

agentVersionId
string<uuid>
required

Immutable agent version id (UUID), as listed by managedAgentsListAgentVersions or reported as an agent's latest_agent_version_id.

Response

An immutable snapshot of a standalone Managed Agent's configuration. Sessions reference a version so a running session cannot change under them.

An immutable snapshot of a standalone Managed Agent's configuration. Sessions reference a version so a running session cannot change under them.

agentId
string
required

Agent this version belongs to (UUID).

agentVersionId
string
required

Identifier for this agent version (UUID). Server-assigned. Pass it when starting a session that must run a specific version.

createdAt
string<date-time>
required

RFC 3339 timestamp of when this record was created. Server-assigned.

defaultCredentialRefs
object[]
required

Narrows this version's default vaults to individual credentials.

defaultVaultIds
string[]
required

Vaults whose credentials are copied into a new session started from this version when the create request omits vault_ids.

disabledIntegrationMcpProviders
string[]
required

Native integration providers whose MCP tools sessions started from this version do not receive. github is ignored, because a GitHub grant always keeps its MCP tools alongside git and gh in the sandbox.

mcpServers
object[]
required

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.

modelConfig
object
required

Default inference settings this version applies to every turn. temperature and top_p are stored but not sent to the model.

name
string
required

The agent's human-readable label as it stood at this version.

organizationId
string
required

Organization that owns this record. Resolved from the authenticated principal; never accepted from the caller.

skills
object[]
required

Skill packages loaded into the runtime at this version, each an entry with the skill reference and its metadata.

system
string
required

System prompt this version prepends to every conversation.

versionNumber
integer<int64>
required

Monotonically increasing version counter within the agent, starting at 1. Server-assigned.

Required range: -9007199254740991 <= x <= 9007199254740991
builtInIntegrations
object[]

Built-in integrations sessions started from this version may use, each naming an organization connection an admin added. Snapshotted with the version.

createdBy
string

Who saved this version: a person's usr_ id, including a script on their API key, or a service account's svc_ id. Absent when no saver was recorded, as on older versions and versions the service saved itself.

defaultCriteria
object[]

This version's default criteria, in order: the criteria defaultRubric renders. Absent when the version has no default rubric, or one saved before criteria were structured that has no structured form.

defaultEvaluatorAgentId
string

Default evaluator for outcomes inherited from this version and explicit outcomes that omit evaluatorAgentId.

defaultProjectId
string

Billing project copied into sessions started from this version when their create request omits project_id. A non-empty session project_id overrides it.

defaultRubric
string

Markdown rubric used when a session inherits a default outcome and this version also has a defaultEvaluatorAgentId. Without a default evaluator, this rubric is fallback criteria when the agent is selected for an evaluation. A session that supplies its own outcome ignores this entirely.

description
string

The agent's free-text note as it stood at this version.

executionCompatibility
enum<string>

Whether this exact immutable version is compatible with the standalone execution context. Omitted by deployments that do not compute it; a client must treat any present value other than compatible as incompatible.

Available options:
compatible,
incompatible
executionCompatibilityReason
object
read-only

Why executionCompatibility is incompatible: the first failing setting. Omitted when compatible or not computed.

fileHistoryEnabled
boolean

Whether sessions created from this version may search and read the session outputs this agent's earlier sessions saved. Omitted means off.

maxConcurrentSessions
integer

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. Outcome evaluation passes do not take a slot.

Required range: 1 <= x <= 10000
metadata
object

Free-form caller-supplied key/value labels. Stored verbatim and never interpreted by the service.

model
string

Public model id this version runs on, in the same form as an agent's model.

multiagent
object

Multi-agent orchestration settings at this version, such as subagent definitions and delegation limits.

nativeIntegrations
object[]

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.

Maximum array length: 25
oversight
object

Course correction of sessions started from this version: advisor, interventionist and supervisor.

supportsNewSessions
boolean

Whether this version's agent type supports new sessions here. Other start requirements still apply. Existing sessions and version history remain available when false.

template
object

Reviewed template revision this version started from.

toolMode
enum<string>

How sessions created from this version reach their tools: native or codemode. Omitted means native.

Available options:
native,
codemode
versionComment
string

Optional single-line note the author attached when saving this version, for change context. Omitted when empty.

Maximum string length: 2000
webSearchEnabled
boolean
default:true

Whether sessions created from this version may use the native web_search tool. Omitted on legacy versions and interpreted as enabled.