{
  "results": [
    {
      "uid": "<string>"
    }
  ]
}

API Reference

Add Memories

Add memory messages to a project. If not specified, the memory will be added to all the sub-types (Episodic, Semantic).

Each memory message represents a discrete piece of information to be stored in the project’s memory system. Messages can include content, metadata, timestamps, and other contextual details.

The producer field indicates who created the message, while the produced_for field specifies the intended recipient. These fields help provide context for the memory and if provided should be user-friendly names.

The endpoint accepts a batch of messages to be added in a single request.

POST

api

memories

{
  "results": [
    {
      "uid": "<string>"
    }
  ]
}

Body

application/json

Specification model for adding memories.

messages

MemoryMessage · object[]

required

A list of messages to be added (batch input).
Must contain at least one message.

Minimum array length: 1

Show child attributes

messages.content

string

required

The content or text of the message.

messages.producer

string

default:user

The sender of the message. This is a user-friendly name for
the LLM to understand the message context. Defaults to 'user'.

messages.produced_for

string

default:""

The intended recipient of the message. This is a user-friendly name for
the LLM to understand the message context. Defaults to an empty string.

messages.timestamp

string<date-time>

The timestamp when the message was created, in ISO 8601 format.
If not provided, the server assigns the current time.

messages.role

string

default:""

The role of the message in a conversation (e.g., 'user', 'assistant',
'system'). Optional; defaults to an empty string.

messages.metadata

Metadata · object

Additional metadata associated with the message, represented as key-value
pairs. Optional; defaults to an empty object.
Retrieval operations may utilize this metadata for filtering.
Use 'metadata.{key}' to filter based on specific metadata keys.

Show child attributes

messages.metadata.{key}

string

org_id

string

default:universal

The unique identifier of the organization.

- Must not contain slashes (`/`).
- Must contain only letters, numbers, underscores, hyphens, and Unicode
  characters (e.g., Chinese/Japanese/Korean). No slashes or other symbols
  are allowed.

This value determines the namespace the project belongs to.

project_id

string

default:universal

The identifier of the project.

- Must be unique within the organization.
- Must not contain slashes (`/`).
- Must contain only letters, numbers, underscores, hyphens, and Unicode
  characters (e.g., Chinese/Japanese/Korean). No slashes or other symbols
  are allowed.

This ID is used in API paths and resource locations.

Response

Successful Response

Response model for adding memories.

results

AddMemoryResult · object[]

required

The list of results for each added memory message.

Show child attributes

results.uid

string

required

The unique identifier of the memory message.

Delete Project

Add Episodic Memories

⌘I

Introduction

MCP Tools

REST API

PythonSDK Client

PythonSDK Server

Add Memories

Body

Response