Content Management

Update a memory (creates new version)

Update a memory by creating a new version. The original memory is preserved with isLatest=false.

patch/v4/memories

Request body

idstring

ID of the memory entry to operate on

contentstring

Exact content match of the memory entry to operate on. Use this when you don't have the ID.

containerTagstring required

Container tag / space identifier. Required to scope the operation.

newContentstring required

The new content that will replace the existing memory

metadataobject

Optional metadata. If not provided, inherits from the previous version.

forgetAfterstring datetime nullable

ISO 8601 datetime string. The memory will be auto-forgotten after this time. Pass null to clear an existing expiry. Omit to inherit from the previous version.

forgetReasonstring nullable

Optional reason for the scheduled forgetting. Cleared automatically when forgetAfter is set to null.

Example request

{
  "id": "mem_abc123",
  "content": "John prefers dark mode",
  "containerTag": "user_123",
  "newContent": "John now prefers light mode",
  "forgetAfter": "2026-06-01T00:00:00Z",
  "forgetReason": "temporary project deadline"
}

Response

Memory updated successfully

idstring required

ID of the newly created memory version

memorystring required

The content of the new memory version

versionnumber required

Version number of this memory entry

parentMemoryIdstring nullable required

ID of the memory this version updates

rootMemoryIdstring nullable required

ID of the first memory in this version chain

createdAtstring datetime required

When this memory version was created

forgetAfterstring datetime nullable required

When this memory will be auto-forgotten, or null if no expiry

forgetReasonstring nullable required

Reason for the scheduled forgetting, or null

Example response

{
  "id": "mem_xyz789",
  "memory": "John now prefers light mode",
  "version": 2,
  "parentMemoryId": "mem_abc123",
  "rootMemoryId": "mem_abc123"
}

Changes

Changed in 5 of the 46 revisions of this API.227

Apr 7, 2026b5edd97adf4a2See the full diff
- ○
  api tag Content Management added
  api-tag-added
- ○
  api tag Memories removed
  api-tag-removed
Mar 26, 2026e519a815da915See the full diff
- ○
  added the new optional request property allOf[subschema #2]/forgetAfter
  new-optional-request-property
- ○
  added the new optional request property allOf[subschema #2]/forgetReason
  new-optional-request-property
- ○
  added the new optional request property allOf[subschema #2]/temporalContext
  new-optional-request-property
- ○
  added the required property forgetAfter to the response with the 200 status
  response-required-property-added
- ○
  added the required property forgetReason to the response with the 200 status
  response-required-property-added
Mar 15, 2026b403181670171See the full diff
- ▲
  request body became required
  request-body-became-required
Mar 12, 20267386f0fb80431See the full diff
- ●
  changed the pattern of the request property allOf[subschema #1]/containerTag from ^[a-zA-Z0-9_-]+$ to ^[a-zA-Z0-9_:-]+$
  request-property-pattern-changed
Mar 9, 20268d6903994bad11See the full diff
- ▲
  added the pattern ^[a-zA-Z0-9_-]+$ to the request property allOf[subschema #1]/containerTag
  request-property-pattern-added
- ●
  the allOf[subschema #1]/containerTag request property's maxLength was set to 100
  request-property-max-length-set

Full history