Skip to main content
GET
TypeScript SDK

Authorizations

x-api-key
string
header
required

Long-lived org API key. Alternative: Authorization: Bearer <key>.

Path Parameters

memory_id
string
required

Response

Successful Response

Unified memory resource — facts, artifacts, episodes marshal to this shape. type is the discriminator; details is the type-specific extension.

Invariant: text is always a short readable preview, regardless of type (fact statement / artifact summary / episode summary).

id
string
required

Stable UUID for this memory row.

type
enum<string>
required

Memory subtype. fact = a single semantic claim extracted from a turn; artifact = a structured object (code, doc, image) referenced by the conversation; episode = a session-scoped summary of a stretch of turns; lesson / procedure = a situated directive recalled by the symbol tripwire (see DirectiveDetails).

Available options:
fact,
artifact,
episode,
lesson,
procedure
text
string
required

Short readable preview. For facts: the claim statement. For artifacts: a summary or title (full body lives in details.full_content, opt-in via include=full_content). For episodes: a summary of the session.

object
string
default:memory

Constant discriminator for the resource type.

Allowed value: "memory"
user_id
string | null

User scope this row belongs to.

agent_id
string | null

Agent scope, if any.

conv_id
string | null

Conversation anchor.

app_id
string | null

App scope, if any.

group_ids
string[]

Group ids associated with this row — the sharing axis. Stamped at ingest time and editable afterward via PATCH /v1/memories/{id} (add_group_ids / remove_group_ids). Reachable as a filter axis via filters: {group_ids: <id>} or {group_ids: {"$in": [<id>, ...]}}.

categories
string[]

Optional category labels from the extraction pipeline.

score
number | null

Vector-similarity score. Present only on search responses; null on list / get-by-id / patch / ingest result rows.

created_at
string<date-time>

ISO-8601 timestamp of original ingest.

updated_at
string<date-time>

ISO-8601 timestamp of the last supersede / consolidation.

details
FactDetails · object

Per-row fact details — sits under Memory.details when Memory.type == "fact".