Memories
Long-term memory CRUD, assets, sources, and memory nodes.
Memories persist facts agents recall across sessions. Memory nodes group related items for structured recall.
Memory endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/v1/memories | List or search memories. |
POST | /api/v1/memories | Save a memory. |
DELETE | /api/v1/memories | Bulk-delete — browser session + step-up. |
DELETE | /api/v1/memories/:id | Delete one memory — browser session + step-up; API keys get 403. |
GET | /api/v1/memories/:id/assets | List binary assets. |
POST | /api/v1/memories/:id/assets | Attach an asset. |
GET | /api/v1/memories/:id/sources | List provenance sources. |
POST | /api/v1/memories/:id/sources | Link a source message or session. |
Memory node endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/v1/memory-nodes | List nodes. |
POST | /api/v1/memory-nodes | Create a node. |
GET | /api/v1/memory-nodes/:id | Fetch a node. |
PATCH | /api/v1/memory-nodes/:id | Update a node. |
DELETE | /api/v1/memory-nodes/:id | Delete a node. |
GET | /api/v1/memory-nodes/:id/items | List items in the node. |
POST | /api/v1/memory-nodes/:id/items | Add an item. |
See Memory for scopes, pinning, and recall behavior.