Skip to main content
GET
Read one memory

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 memory belongs to.

memoryId
string<uuid>
required

Memory id (UUID) returned by the agent memory listing.

Response

OK

byteSize
integer<int64>
required

Size of the content in bytes.

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

Server-assigned RFC 3339 timestamp of when the memory was created.

memoryId
string
required

Server-assigned id of the memory.

memoryStoreId
string
required

Store this memory belongs to.

organizationId
string
required

Organization that owns this record. Resolved from the API key; never accepted from the caller.

path
string
required

Address of the memory within its store, e.g. /conventions/testing.md. The path hierarchy is the routing structure an agent browses, so it carries the meaning a per-memory prompt description otherwise would.

status
enum<string>
required

active memories are offered to sessions; retired and superseded memories are kept for history, so later learning runs can see what was already tried.

Available options:
active,
retired,
superseded
updatedAt
string<date-time>
required

Server-assigned RFC 3339 timestamp of the most recent change.

content
string

Full text of the memory. Returned when reading one memory, omitted from listings.

contentSha256
string

SHA-256 of the current memory content.

headVersionId
string

Version id of the current content.

reflectionId
string

Reflection run that wrote this memory. Empty for a memory a human seeded.

summary
string

One-line description, shown in search results and the console. Not disclosed in the system prompt.

supersededByMemoryId
string

Memory that replaced this one, when a learning run superseded it.