Memory API

Store and retrieve key-value memory for agents

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"
}

Errors

Code	Description
400	agentId query parameter required
401	Unauthorized
404	Agent not found

Store memory (single key)

POST /api/memory

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"
}

Errors

Code	Description
400	agentId required, memory data required, or value too large (max 100 KB)
401	Unauthorized
404	Agent not found

Store memory (bulk)

POST /api/memory

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"
}

Errors

Code	Description
400	agentId required, memory data required, or too many keys (max 50)
401	Unauthorized
404	Agent not found