63cd7fe102
- Rename skill/ to skills/ for consistency with naming conventions - Rename agent/ to agents/ and command/ to commands/ - Update AGENTS.md with all directory references - Update scripts/test-skill.sh paths - Update prompts/athena.txt documentation This aligns with best practices of using plural directory names and updates all documentation to reflect the new structure.
3.1 KiB
3.1 KiB
Mem0 REST API Reference
Base URL: http://localhost:8000
Endpoints
Health Check
GET /health
Returns 200 if server is running.
Create Memories
POST /memories
Content-Type: application/json
Request Body (MemoryCreate):
{
"messages": [
{"role": "string", "content": "string"}
],
"user_id": "string | null",
"agent_id": "string | null",
"run_id": "string | null",
"metadata": {"key": "value"} | null
}
messages(required): Array of Message objectsrole: Role of message sender ("user" or "assistant")content: Message content string
user_id: Optional user identifieragent_id: Optional agent identifierrun_id: Optional session/run identifiermetadata: Optional key-value metadata
Get All Memories
GET /memories
Query Parameters:
user_id(string, optional): Filter by useragent_id(string, optional): Filter by agentrun_id(string, optional): Filter by run/session
Get Single Memory
GET /memories/{memory_id}
Path Parameters:
memory_id(string, required): Memory ID
Update Memory
PUT /memories/{memory_id}
Content-Type: application/json
Path Parameters:
memory_id(string, required): Memory ID
Request Body: Object with updated fields
Delete Memory
DELETE /memories/{memory_id}
Path Parameters:
memory_id(string, required): Memory ID
Delete All Memories
DELETE /memories
Query Parameters:
user_id(string, optional): Delete for specific useragent_id(string, optional): Delete for specific agentrun_id(string, optional): Delete for specific run
Search Memories
POST /search
Content-Type: application/json
Request Body (SearchRequest):
{
"query": "string",
"user_id": "string | null",
"agent_id": "string | null",
"run_id": "string | null",
"filters": {"key": "value"} | null
}
query(required): Search query stringuser_id: Optional user filteragent_id: Optional agent filterrun_id: Optional run filterfilters: Optional additional filters
Get Memory History
GET /memories/{memory_id}/history
Path Parameters:
memory_id(string, required): Memory ID
Returns version history for a memory.
Configure Mem0
POST /configure
Content-Type: application/json
Request Body: Configuration object (varies by setup)
Reset All Memories
POST /reset
Warning: Completely resets all stored memories.
Error Responses
422 Validation Error:
{
"detail": [
{
"loc": ["body", "field_name"],
"msg": "error message",
"type": "error_type"
}
]
}
Data Schemas
Message
{
"role": "string",
"content": "string"
}
MemoryCreate
{
"messages": [Message],
"user_id": "string | null",
"agent_id": "string | null",
"run_id": "string | null",
"metadata": "object | null"
}
SearchRequest
{
"query": "string",
"user_id": "string | null",
"agent_id": "string | null",
"run_id": "string | null",
"filters": "object | null"
}