Get the agent version a session runs
Returns the version of its agent a root session runs now, the version it is set to run, whether a move is pending or was refused, the agent’s latest version, and how far each open thread of the session tree has followed. The state changes as the session works, so read it again rather than keeping a copy. A session that is a member of another session’s tree answers 409 conflict; read its root. A session that was not started from an agent has no version to read and answers 409 conflict too.
Authorizations
A Recursion API key, created in the console under API keys.
Headers
Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.
1Organization 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.
1Path Parameters
Session id (UUID) as returned by managedAgentsStartSession or managedAgentsListSessions.
Response
The agent version a root session runs, the move waiting to take effect if any, and how far each member of the session tree has followed.
The agent version a root session runs, the move waiting to take effect if any, and how far each member of the session tree has followed.
Version the session is set to run: the pending version while a move is waiting, otherwise the version it runs now.
Version the session runs now.
Why the most recent move was refused, or null. Null while a newer move is pending.
The agent's newest version, or null when the agent has been deleted.
The root session and every open thread of its tree, root first, with how far each has followed the root.
The move waiting to take effect, or null.
current: nothing is waiting. pending: agentVersionId takes effect before the session's next model call. failed: the last move was refused and the session stayed on currentAgentVersionId; lastFailure says why.
current, pending, failed Number of currentAgentVersionId within its agent. Absent when the number can no longer be read.
1 <= x <= 9007199254740991