Memories API Endpoints
Create, search, update, and remove memories.
- POSTStore a memory
Store a new memory. This endpoint is asynchronous and returns 202 Accepted with a job_id.
/api/v1/memories
- GETCheck ingest job
Poll the status of an ingest job. Returns job status and the resulting memory when complete.
/api/v1/memories/jobs/{job_id}
- POSTSearch memories
Semantic search over memories (and relationship edges in raw mode). Optional scope narrows by memory scope tokens (PostgreSQL regex per entry, AND). Use rerank for nodes-only top-k after vector retrieval; use full_scope to list every memory matching scope (skips vector ranking; requires non-empty scope).
/api/v1/memories/search
- GETGet a memory
Fetch a single memory by ID.
/api/v1/memories/{memory_id}
- PUTUpdate a memory
Update the content or tags of an existing memory.
/api/v1/memories/{memory_id}
- DELETEDelete a memory
Delete a single memory by ID.
/api/v1/memories/{memory_id}
- DELETEBatch delete
Delete multiple memories by ID, tag, or category in one request.
/api/v1/memories/bulk
- GETCount memories
Return the total number of memories for your tenant.
/api/v1/memories/count