API Reference

Fresh

Complete REST API documentation for the Mem0 Platform.

Base URL

https://api.mem0.ai/v1

Authentication

All requests require an API key in the Authorization header:

Authorization: Token your-api-key

Endpoints

Memory Operations

Method	Endpoint	Description
POST	/memories/	Add memories
GET	/memories/	Get memories
POST	/memories/search/	Search memories
PUT	/memories/{memory_id}/	Update memory
DELETE	/memories/{memory_id}/	Delete memory
GET	/memories/{memory_id}/	Get single memory
GET	/memories/{memory_id}/history/	Memory history
POST	/memories/export/	Create export
GET	/memories/export/{export_id}/	Get export
POST	/memories/batch/update/	Batch update
POST	/memories/batch/delete/	Batch delete
DELETE	/memories/	Delete all memories
POST	/memories/{memory_id}/feedback/	Submit feedback

Events

Method	Endpoint	Description
GET	/events/	List events
GET	/events/{event_id}/	Get event

Entities

Method	Endpoint	Description
GET	/entities/users/	List users
DELETE	/entities/users/{user_id}/	Delete user

Organizations

Method	Endpoint	Description
POST	/orgs/	Create org
GET	/orgs/	List orgs
GET	/orgs/{org_id}/	Get org
GET	/orgs/{org_id}/members/	List members
POST	/orgs/{org_id}/members/	Add member
DELETE	/orgs/{org_id}/	Delete org

Projects

Method	Endpoint	Description
POST	/orgs/{org_id}/projects/	Create project
GET	/orgs/{org_id}/projects/	List projects
GET	/projects/{project_id}/	Get project
GET	/projects/{project_id}/members/	List members
POST	/projects/{project_id}/members/	Add member
DELETE	/projects/{project_id}/	Delete project

Webhooks

Method	Endpoint	Description
POST	/webhooks/	Create webhook
GET	/webhooks/{webhook_id}/	Get webhook
PUT	/webhooks/{webhook_id}/	Update webhook
DELETE	/webhooks/{webhook_id}/	Delete webhook

Request Examples

Add Memory

curl -X POST https://api.mem0.ai/v1/memories/ \
  -H "Authorization: Token your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {"role": "user", "content": "I love sci-fi movies"},
      {"role": "assistant", "content": "Noted! Any favorites?"}
    ],
    "user_id": "alice"
  }'

Search Memories

curl -X POST https://api.mem0.ai/v1/memories/search/ \
  -H "Authorization: Token your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What movies does she like?",
    "filters": {
      "AND": [{"user_id": "alice"}]
    }
  }'

Get All Memories

curl -X GET "https://api.mem0.ai/v1/memories/?user_id=alice" \
  -H "Authorization: Token your-api-key"

Delete Memory

curl -X DELETE https://api.mem0.ai/v1/memories/mem_123/ \
  -H "Authorization: Token your-api-key"