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

Authorizations

Authorization
string
header
required

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

Headers

If-None-Match
string

Previously returned ETag. When it still identifies the current representation, the response is 304 with no body.

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

Model and guidance for automatic learning from a Recursion agent's finished sessions. An empty model selection uses the Luna default.

Model and guidance for automatic learning from a Recursion agent's finished sessions. An empty model selection uses the Luna default.

cooldownSeconds
integer<int64>
required

Minimum time between consolidation runs in seconds; 0 inherits the platform default of 3600.

Required range: -9007199254740991 <= x <= 9007199254740991
effectiveCooldownSeconds
integer<int64>
required
read-only

Active minimum seconds between runs after applying inheritance.

Required range: -9007199254740991 <= x <= 9007199254740991
effectiveMaxEvidencePerRun
integer<int64>
required
read-only

Active report limit after applying inheritance.

Required range: -9007199254740991 <= x <= 9007199254740991
effectiveMinNewEvidence
integer<int64>
required
read-only

Active early-consolidation threshold after applying inheritance.

Required range: -9007199254740991 <= x <= 9007199254740991
enabled
boolean
required

Whether this agent learns from completed sessions and attaches its learned store to new sessions.

enabledEditable
boolean
required
read-only

Whether this deployment permits changing the enabled setting.

maxEvidencePerRun
integer<int64>
required

Maximum reports one consolidation may read; 0 inherits the platform default of 50.

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

New useful reports that trigger an early consolidation; the first run and aged backlog can run below this threshold. 0 inherits the platform default of 5.

Required range: -9007199254740991 <= x <= 9007199254740991
instructions
string

Standing guidance for every memory consolidation run. Capped at 4096 characters.

memoryModelRef
string

Model used for all memory learning stages. Empty uses the Luna default.

reflectorAgentId
string

Agent selected to curate this agent's memory. Empty uses the platform curator.

revision
string
read-only

Strong revision validator for the current settings representation. Send it in If-Match when changing settings.