v38

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-1793196344.2 KB

Memories

Add a memory

Adds an arbitrary document to the index. This can be any text, email, call transcript, etc. The document will be processed and made available for querying once the processing is complete.

post/memories/add

Request body

resource_idstring

The resource ID to add the document to. If not provided, a new resource ID will be generated. If provided, the document will be updated if it already exists.

textstring required

Full text of the document.

collectionstring nullable

The collection to add the document to — deprecated, set the collection using metadata instead.

titlestring nullable

Title of the document.

datestring date-time

Date of the document. Depending on the document, this could be the creation date or date the document was last updated (eg. for a chat transcript, this would be the date of the last message). This helps the ranking algorithm and allows you to filter by date range.

metadataobject nullable

Custom metadata for filtering. Keys must be alphanumeric with underscores, max 64 chars. Values must be string, number, boolean, or null.

Example request

{
  "collection": "my-collection",
  "metadata": {
    "author": "John Doe",
    "date": "2025-05-20T02:31:00Z",
    "rating": 3
  },
  "text": "...",
  "title": "My Document"
}

Response

Successful Response

resource_idstring required

All 93 operations