Skip to main content
POST
Create Memory

Headers

x-client-id
string<uuid> | null
x-memory-base-config-id
string<uuid> | null

Body

application/json

Schema for creating memory entries

app_name
string
required

Application name (usually agent_id)

user_id
string
required

User ID

content
string
required

Memory content to store

metadata
Metadata · object | null

Optional metadata dictionary

session_id
string | null

Optional session ID (will be generated if not provided)

short_term_max_messages
integer | null

Maximum messages in short-term memory before compression

Required range: 10 <= x <= 500
compression_interval
integer | null

Compress every N messages to medium-term memory

Required range: 5 <= x <= 100

Response

Successful Response

data
any
required

Response payload

meta
any
required

Metadata

success
boolean
default:true

Success indicator

message
string | null

Optional success message