Skip to main content
POST
/
api
/
v1
/
memories
Create Memory
curl --request POST \
  --url https://api.example.com/api/v1/memories

​
Request Body

{
  "kind": "core",
  "content": "Prefers concise summaries.",
  "scope": "user"
}
FieldTypeDescription
kindcore, archivalDefaults to core
contentstringRequired; non-empty
scopeuser, agentDefaults to user
agent_idstringRequired when scope=agent; rejected for user-scoped rows

​
Response

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "kind": "core",
  "content": "Prefers concise summaries.",
  "scope": "user",
  "agent_id": null,
  "created_at": "2026-04-30T16:00:00",
  "updated_at": "2026-04-30T16:00:00"
}