Skip to main content

Memories API

Store and manage memories within a space.

Add a Memory

Request Body:
ParameterTypeRequiredDescription
space_idstringYesWhich space to store in
contentstringYesThe memory text
contextstringNoFreeform context for the memory
timestampstringNoISO 8601 timestamp (defaults to now)
metadataobjectNoCustom key-value data
Response (200 OK):
Python SDK:

List Memories in a Space

Query ParamTypeDescription
limitintegerMax results
offsetintegerPagination offset
qstringOptional text filter
typestringOptional memory type filter
Response (200 OK):
Note: list results use id/text/date field names, distinct from the memory_id/content names used when adding or searching memories.

Delete a Memory

Response: 204 No Content - permanently deleted, no body.
There is no endpoint to fetch or update a single memory by ID - list, search, or delete are the available operations.

Error Responses

All errors share this shape:
StatusCodeCause
400bad_requestInvalid request body
401unauthorizedMissing/invalid API key
403forbiddenSpace not owned by your org
404not_foundMemory or space doesn’t exist
422validation_errorBody fails schema validation
429rate_limitedQuota or rate limit exceeded
See the full error reference.

Next Steps

Search API

Query memories semantically

Insights API

Synthesize insights