Memories API
Store and manage memories within a space.Add a Memory
| Parameter | Type | Required | Description |
|---|---|---|---|
space_id | string | Yes | Which space to store in |
content | string | Yes | The memory text |
context | string | No | Freeform context for the memory |
timestamp | string | No | ISO 8601 timestamp (defaults to now) |
metadata | object | No | Custom key-value data |
List Memories in a Space
| Query Param | Type | Description |
|---|---|---|
limit | integer | Max results |
offset | integer | Pagination offset |
q | string | Optional text filter |
type | string | Optional memory type filter |
id/text/date field names, distinct from the memory_id/content names used when adding or searching memories.
Delete a Memory
204 No Content - permanently deleted, no body.
Error Responses
All errors share this shape:| Status | Code | Cause |
|---|---|---|
| 400 | bad_request | Invalid request body |
| 401 | unauthorized | Missing/invalid API key |
| 403 | forbidden | Space not owned by your org |
| 404 | not_found | Memory or space doesn’t exist |
| 422 | validation_error | Body fails schema validation |
| 429 | rate_limited | Quota or rate limit exceeded |
Next Steps
Search API
Query memories semantically
Insights API
Synthesize insights