Skip to main content
GET
Get an agent's memory summary

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) as returned by managedAgentsCreateAgent or managedAgentsListAgents.

Response

One Recursion agent's living memory collection and automatic learning progress.

One Recursion agent's living memory collection and automatic learning progress.

agentId
string
required

Agent whose sessions contribute to this memory.

agentName
string
required

Current display name of the agent.

effectiveModel
string
required

Resolved memory model after the Luna default or an explicit override is applied.

failedSessionCount
integer<int64>
required

Sessions whose extraction failed permanently and will not be retried automatically.

Required range: -9007199254740991 <= x <= 9007199254740991
memoryCount
integer<int64>
required

Number of current memories available for recall.

Required range: -9007199254740991 <= x <= 9007199254740991
pendingSessionCount
integer<int64>
required

Useful session reports waiting to be incorporated.

Required range: -9007199254740991 <= x <= 9007199254740991
revision
integer<int64>
required

Committed collection revision, increased by each applied update.

Required range: -9007199254740991 <= x <= 9007199254740991
state
enum<string>
required

Whether learning is off, waiting for evidence, current, updating, or retrying after a failure.

Available options:
disabled,
waiting,
idle,
updating,
delayed
totalBytes
integer<int64>
required

Total bytes of current memory content.

Required range: -9007199254740991 <= x <= 9007199254740991
lastCheckedAt
string<date-time>

Most recent successful automatic memory update, including checks that changed nothing.

lastUpdatedAt
string<date-time>

Most recent change to current memory content.

memoryModelRef
string

Explicit model override; absent uses the Luna default.

memoryStoreId
string

Permanent collection id; absent before its first session starts.

nextRetryAt
string<date-time>

Earliest next retry after a failed learning run.