API Reference
Memories API
List, search, create, and manage long-term agent memories.
GET /v1/memories
List memories for the authenticated user. Supports semantic search.
Query parameters:
q— semantic search query (uses pgvector cosine similarity)kind— filter byfact | preference | event | skill-notelimit— max results (default 20, max 100)visibility— filter byprivate | team | org
Response:
{
"memories": [
{
"id": "uuid",
"kind": "fact",
"content": "Alice is VP of Engineering at Acme Corp",
"visibility": "private",
"createdAt": "2026-04-18T..."
}
]
}
POST /v1/memories
Add a new memory.
Request:
{
"kind": "fact",
"content": "Customer renewal date is Q3 2026",
"visibility": "team"
}
PATCH /v1/memories/:id
Update visibility.
Request:
{ "visibility": "team" }
DELETE /v1/memories/:id
Delete a memory. Requires ownership or memory.delete permission.
