Skip to main content
POST /v1/memory

​
Request body

FieldTypeRequiredDescription
user_idstring✅User to store memory for
messagesarray✅List of {role, content} message objects
app_idstringNamespace memories per application
workspace_idstringNamespace memories per workspace or team
agent_idstringNamespace memories per agent

​
Example

curl -X POST http://localhost:8000/v1/memory \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "alice",
    "app_id": "app_a",
    "workspace_id": "team_1",
    "messages": [
      { "role": "user", "content": "I prefer dark mode and short answers." }
    ]
  }'

​
Response

{
  "stored": 1,
  "memory_ids": ["mem_3f7a1c2d9e4b"]
}