Memories

Update Memory

Update a memory's content and/or metadata.

If content is changed, the HNSW vector is re-embedded automatically. Metadata is merged (not replaced) — only specified keys are updated.

Optional scope ("<kind>:<value>") stamps the write; must be within the caller's visible scopes (403 otherwise). Defaults to user:<user_id>.

patch/memories/{memory_id}

Request

Path parameters

memory_idstring required

Request body

contentstring nullable

Memory text (at most 65536 characters and 8191 tokens)

metadataobject nullable

Properties to merge

scopestring nullable

Optional explicit write scope "<kind>:<value>" (kinds: user/team/org/project). Must be within the caller's visible scopes; defaults to user:<user_id>.

Response

Successful Response

idstring required

Memory ID (UUID)

user_idstring nullable

Owner user ID

typestring

Memory type: document, episode, preference

labelstring

Graph label

contentstring nullable

Text content or summary

statusstring

Lifecycle status

metadataobject nullable

Additional properties

created_atstring nullable

Creation timestamp (ISO)

updated_atstring nullable

Last update timestamp (ISO)

contextsstring[] nullable

Context sentences the entity appeared in (GET by id only; additive)

inferencesstring[] nullable

Inference text generated for this node (GET by id only; additive)

Changes

No recorded changes to this operation across all 1 revision of this API.