Skip to main content
Submits a user–assistant conversation to the project. Structured memories are automatically extracted from the messages and stored asynchronously. The response includes an event ID that can be used to track processing progress.
Permission required: project:mem_add · instance

Path Parameters

id
string
required
Project ID (format: proj-{uuid})

Request Body

messages
array
required
Array of message objects representing the conversation. Each message contains a role (user or assistant) and content.
user_id
string
Unique identifier of the user associated with this memory
chat_session_id
string
Unique identifier of the chat session
infer
boolean
default:"true"
Whether to infer memories from messages, or store messages directly. Defaults to true (infer mode).
metadata
object
Additional arbitrary metadata key-value pairs

Response

data
object