API Documentation

REST API endpoints for the Agentic Memory Platform

Authentication: All API endpoints (except /health) require an API key in the Authorization header:
Authorization: Bearer <api_key>

Health Check

GET /health

Health check endpoint (no authentication required)

POST /api/v1/add

Add memories (supports Mem0-compatible and structured formats)

POST /api/v1/contexts

Create a new context

GET /api/v1/contexts

List all contexts

GET /api/v1/contexts/{contextID}

Get a specific context

PUT /api/v1/contexts/{contextID}

Update a context

DELETE /api/v1/contexts/{contextID}

Delete a context (cascades to episodes and interactions)

POST /api/v1/contexts/{contextID}/episodes

Create a new episode within a context

GET /api/v1/contexts/{contextID}/episodes

List episodes for a context

GET /api/v1/contexts/{contextID}/episodes/{episodeID}

Get a specific episode

PUT /api/v1/contexts/{contextID}/episodes/{episodeID}

Update an episode

DELETE /api/v1/contexts/{contextID}/episodes/{episodeID}

Delete an episode (cascades to interactions)

POST /api/v1/episodes/{episodeID}/interactions

Create a new interaction within an episode

GET /api/v1/episodes/{episodeID}/interactions

List interactions for an episode

GET /api/v1/interactions/{interactionID}

Get a specific interaction

DELETE /api/v1/interactions/{interactionID}

Delete an interaction

POST /api/v1/interactions/batch

Batch create interactions

DELETE /api/v1/interactions/batch

Batch delete interactions

POST /api/v1/search/semantic

Semantic search using embeddings

POST /api/v1/search/hybrid

Hybrid search combining semantic search with dimension filters