Skip to main content
POST
Save a memory

Authorizations

Authorization
string
header
required

A scoped Integration key, prefixed cint_. Send as Authorization: Bearer cint_... on every request. Server-side only. Legacy personal cmem_... keys remain accepted during migration; team/org-scoped cmem_... keys are not valid on this API.

Body

application/json
endUserId
string
required

Your stable internal user ID. No colon allowed.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9@._-]{1,128}$
Example:

"u_123"

content
string
required

The distilled observation to remember.

Minimum string length: 1
Example:

"User prefers smaller islands, wants to avoid crowds."

containerTag
string

Optional free-form grouping label (e.g. "profile", "sessions"). Omit and everything goes to "default".

Example:

"profile"

metadata
object

Optional arbitrary JSON stored alongside the memory.

Example:

Response

Memory saved (or deduplicated).

success
boolean
required
memory
object
deduped
boolean

True when identical content already existed (no-op write).

created
boolean

True when a new memory row was created.