Sign in

v3

latestOpenAPI 3.0.1Apache 2.02026-08-065516357.9 KB
memories

Update a memory's text, metadata, or expiration date.

put/v1/memories/{memory_id}/

Path parameters

memory_idstring uuid required

The unique identifier of the memory to update.

Request body

textstring

The updated text content of the memory

metadataobject

Additional metadata associated with the memory

expiration_datestring date nullable

Expiration date in YYYY-MM-DD format, or null to clear the expiration date.

Response

Successfully updated memory.

idstring uuid

The unique identifier of the updated memory.

memorystring

The updated content of the memory.

user_idstring nullable

Identifier of the user associated with this memory

agent_idstring nullable

The identifier of the agent associated with this memory, if any.

app_idstring nullable

The identifier of the app associated with this memory, if any.

session_idstring nullable

The run identifier associated with this memory, returned as session_id.

metadataobject nullable

Additional metadata associated with the memory

categoriesstring[] nullable
created_atstring date-time

Timestamp of when the memory was created.

updated_atstring date-time

Timestamp of when the memory was last updated.

expiration_datestring date nullable

The date when the memory will expire. Format: YYYY-MM-DD.

structured_attributesobject nullable

System-derived temporal breakdown of the memory's creation time (e.g. year, month, day_of_week).

replaced_bystring nullable

ID of the memory that superseded this one, if any.

synthesizedboolean

Whether this memory was synthesized rather than directly extracted.

lifecycle_statestring

Lifecycle state of the memory.