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.

POST /memory-blobs

Create Memory

cURL

curl --request POST \
  --url https://api.memoram.app/api/v1/memory-blobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "memoryKey": "<string>",
  "content": "<string>",
  "title": "<string>",
  "summary": "<string>",
  "tags": [
    "<string>"
  ],
  "importance": 0.8,
  "confidence": 0.95,
  "source": "my-chat-app"
}
'

201

{
  "id": "<string>",
  "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "source": "<string>",
  "title": "<string>",
  "summary": "<string>",
  "importance": 123,
  "confidence": 123,
  "tags": [
    "<string>"
  ],
  "tag_ids": [
    "<string>"
  ]
}

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<float>

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

Example:

0.8

confidence · number<float>

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<float>

confidence · number<float>

tags · string[]

tag_ids · string[]