Create Memory

Create a new user memory with content and associated topics. Memories are used to store contextual information for users across conversations.

POST /memories

Create Memory

cURL

curl --request POST \
  --url https://api.example.com/memories \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "memory": "<string>",
  "user_id": "<string>",
  "topics": [
    "<string>"
  ]
}
'

200

{
  "memory_id": "mem-123",
  "memory": "User prefers technical explanations with code examples",
  "topics": [
    "preferences",
    "communication_style",
    "technical"
  ],
  "user_id": "user-456",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

db_id · string | null

Database ID to use for memory storage

Body

application/json

Define the payload expected for creating a new user memory

memory · string · required

user_id · string | null

topics · string[] | null

Response

200

application/json

Memory created successfully

memory_id · string · required

memory · string · required

topics · string[] | null · required

agent_id · string | null · required

team_id · string | null · required

user_id · string | null · required

updated_at · string<date-time> | null · required