Skip to main content
POST
Create Memory Event

Headers

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

Body

application/json

Schema for creating a single memory event (FIFO)

app_name
string
required

Application name (usually agent_id)

user_id
string
required

User ID

role
string
required

Role of the message ('user' or 'agent')

content
string
required

Content of the message

max_messages
integer | null

Maximum messages before removing oldest (FIFO)

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

Compress every N messages into medium-term memory (optional)

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