Skip to main content
GET
Get one memory 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

memoryStoreId
string<uuid>
required

Memory store id (UUID) the version belongs to.

memoryVersionId
string<uuid>
required

Memory version id (UUID) returned by managedAgentsListMemoryVersionsV2.

Response

OK

authorKind
enum<string>
required

Who wrote this version.

Available options:
session,
api,
reflection,
admin
createdAt
string<date-time>
required

Server-assigned RFC 3339 timestamp of when this version was written.

memoryId
string
required

Memory this version describes. The memory may since have been deleted.

memoryStoreId
string
required

Store this version belongs to.

memoryVersionId
string
required

Server-assigned id of the version.

operation
enum<string>
required

What this version records.

Available options:
create,
update,
rename,
delete,
retire
organizationId
string
required

Organization that owns this record.

path
string
required

Path of the memory as it stood at this version.

authorPrincipal
string

Caller identity that wrote this version, when an API caller did.

authorSessionId
string

Session that wrote this version, when a session did.

byteSize
integer<int64>

Size of the content at this version in bytes.

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

Content as it stood at this version. Empty once redacted, and omitted from listings.

contentSha256
string

SHA-256 of the content at this version.

evidenceSessionIds
string[]

Sessions supporting this version, scoped to the same agent and organization.

rationale
string

Why this memory was added, changed, merged, or retired.

redactedAt
string<date-time>

Set when the content was scrubbed for compliance. Author and timestamp are preserved.

redactedBy
string

Caller that redacted this version.

reflectionId
string

Learning run that produced this version.

status
enum<string>

Memory lifecycle state after this change.

Available options:
active,
retired,
superseded
summary
string

Summary as it stood at this version.

supersededByMemoryId
string

Surviving memory when this version records a merge.