Skip to main content
POST
/
v1
/
memory
Store memory
curl --request POST \
  --url http://localhost:8000/v1/memory \
  --header 'Content-Type: application/json' \
  --data '
{
  "user_id": "alice",
  "app_id": "my_app",
  "workspace_id": "team_1",
  "messages": [
    {
      "role": "user",
      "content": "I prefer dark mode and short answers."
    }
  ]
}
'
{
  "stored": 1,
  "memory_ids": [
    "mem_3f7a1c2d9e4b"
  ]
}

Body

application/json
user_id
string
required

User identifier. Required for all operations.

messages
object[]
required

One or more conversation messages to store.

app_id
string | null

Optional application namespace.

workspace_id
string | null

Optional workspace or team namespace.

agent_id
string | null

Optional agent namespace.

Response

200 - application/json

Memories stored successfully

stored
integer

Number of messages stored.

memory_ids
string[]

IDs of the created memory records.