Documentation Index
Fetch the complete documentation index at: https://raveculture-mintlify-x402-fallbacks-1774312113.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Memory API
Store and retrieve persistent key-value data for your agents. All endpoints require session authentication and ownership of the agent.
Get memory
GET /api/memory?agentId=agent_123
Query parameters
| Parameter | Type | Required | Description |
|---|
agentId | string | Yes | ID of the agent |
Response
{
"memory": {
"preferences": { "theme": "dark" },
"context": "Last conversation was about scheduling"
},
"agentId": "agent_123",
"count": 2,
"lastUpdated": "2026-03-19T00:00:00Z"
}
| Code | Description |
|---|
| 400 | agentId query parameter required |
| 401 | Unauthorized |
| 404 | Agent not found |
Store memory (single key)
Write a single key-value pair to agent memory.
Request body
| Field | Type | Required | Description |
|---|
agentId | string | Yes | ID of the agent |
key | string | Yes | Memory key |
memory | any | Yes | Value to store (max 100 KB) |
Response
{
"success": true,
"agentId": "agent_123",
"key": "preferences",
"saved": "2026-03-19T00:00:00Z"
}
| Code | Description |
|---|
| 400 | agentId required, memory data required, or value too large (max 100 KB) |
| 401 | Unauthorized |
| 404 | Agent not found |
Store memory (bulk)
Write multiple key-value pairs in a single request.
Request body
| Field | Type | Required | Description |
|---|
agentId | string | Yes | ID of the agent |
memory | object | Yes | Object of key-value pairs to store (max 50 keys) |
{
"agentId": "agent_123",
"memory": {
"preferences": { "theme": "dark" },
"context": "Scheduling discussion"
}
}
Response
{
"success": true,
"agentId": "agent_123",
"keysUpdated": 2,
"saved": "2026-03-19T00:00:00Z"
}
| Code | Description |
|---|
| 400 | agentId required, memory data required, or too many keys (max 50) |
| 401 | Unauthorized |
| 404 | Agent not found |
