Create Memory

Create a new memory for the current user.

This endpoint allows users to create personal memories that can be used for context in future conversations and interactions.

POST /api/v1/memories

Create Memory

cURL

curl --request POST \
  --url https://api.example.com/api/v1/memories \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "user_id": "<string>",
  "memory": "<string>",
  "memory_type": "user",
  "topics": [
    "<string>"
  ],
  "metadata": {}
}
'

200

{
  "memory_id": "<string>",
  "message": "<string>",
  "memory": {
    "memory_id": "<string>",
    "user_id": "<string>",
    "memory": "<string>",
    "topics": [
      "<string>"
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "metadata": {}
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Workspace-Id · string | null

The workspace ID

Body

application/json

Schema for creating a new memory.

user_id · string · required

The user ID who owns the memory.

memory · string · required

The memory content to store.

memory_type · string | null · default: user

The type of memory. 'user', 'agent', 'team', 'workflow'.

topics · string[] | null

Topics associated with the memory.

metadata · Metadata · object

Additional metadata for the memory.

Response

200

application/json

Successful Response

Schema for memory creation response.

memory_id · string · required

ID of the created memory.

message · string · required

Success message.

memory · MemoryResponse · object · required

The created memory details.

Show child attributes