Skip to main content
POST
Store a new memory (background processing)

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Body

userId
string
required

Unique identifier for the user storing the memory

Minimum string length: 1
Example:

"user_123"

content
string
required

The actual content/text to be stored. This can be either a string or a JSON object. The JSON object format is: [{ "role": "user", "content": "string" }, { "role": "assistant", "content": "string" }]

Required string length: 1 - 30000
Example:

"[{ \"role\": \"user\", \"content\": \"I prefer dark mode\" }, { \"role\": \"assistant\", \"content\": \"I will set the dark mode\" }]"

User consent flag - must be true to store the memory (required for compliance)

Example:

true

projectId
string | null

Project identifier to associate the memory with (optional)

Example:

"project_abc"

tags
string[] | null

Optional tags to categorize and filter memories

Example:
metadata
any | null

Optional JSON Metadata to categorize and filter memories

Example:

Response

Accepted