Skip to content

Memory

Agent memory allows your agent to remember information across separate conversations. The memory API lets you read, add, and delete memory entries programmatically.


List memory — GET /api/memory

Terminal window
GET /api/memory?user_id=user_123&limit=50

Response:

{
"memories": [
{
"memory_id": "mem_abc",
"content": "User prefers code examples in TypeScript",
"category": "preference",
"user_id": "user_123",
"created_at": "2025-03-15T10:00:00Z"
}
]
}

Add a memory — POST /api/memory

{
"content": "User is on the Enterprise plan",
"category": "context",
"user_id": "user_123"
}

Delete a memory — DELETE /api/memory/{memory_id}

Returns 204 No Content on success.


Clear all memories for a user — DELETE /api/memory?user_id={user_id}