Create Memory

Create a new memory blob for a user. Requires the user’s ID and Memory Key obtained from an approved access request. Content should ideally be encrypted client-side before sending, or the API/SDK can handle encryption.

Create a new memory blob for a user. Requires the user’s ID and Memory Key obtained from an approved access request.

Content sent in the content field should ideally be encrypted client-side using the user’s encryption_key before sending. Alternatively, if sending plaintext, ensure the API or SDK handles server-side encryption.

Authorization

Requires Bearer token authentication using your Developer JWT.

Authorizations

Authorization · string · header · required

JWT token obtained via /auth/token endpoint.

Body

application/json

user_id · string<uuid> · required

User's unique ID.

memoryKey · string · required

User's memory key.

content · string · required

The memory content (plaintext or pre-encrypted depending on implementation).

title · string

Optional title for the memory.

summary · string

Optional brief summary of the memory.

tags · string[]

List of tag names (strings) to associate. New tags will be created if they don't exist.

importance · number

Optional importance score (e.g., 1-5 or 0-1).

Example:

0.8

confidence · number

Optional confidence score (0-1).

Example:

0.95

source · string

Optional identifier for the source application/context.

Example:

"my-chat-app"

Response

201

application/json

Memory blob created successfully.

Represents a memory blob as returned by Create/Update operations (content is not included).

id · string

user_id · string<uuid>

created_at · string<date-time>

updated_at · string<date-time>

source · string

title · string

summary · string

importance · number

confidence · number

tags · string[]

tag_ids · string[]