Memories

Add multiple memories

Changed on

Adds multiple documents to the index in a single request.

All items are validated before processing begins. If any item fails validation, the entire batch is rejected with a 422 error detailing which items failed and why.

Maximum 100 items per request. Each item follows the same schema as the single-item /memories/add endpoint.

post/memories/add/bulk

Request

  • Base URL
    https://api.hyperspell.com
  • URL
    https://api.hyperspell.com/memories/add/bulk
  • Auth
    HTTP bearer

Headers

X-As-Userstring nullable

Optionally set this header to act as a specific user when using an API Key, equivalent to first exchanging the API Key for a User Token

Request body

Example request

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

Response

Successful Response

successboolean
countinteger required

Number of items successfully processed

Changes

    • warning

      added the new gong enum value to the // response property for the response status

    • warning

      added the new fireflies enum value to the // response property for the response status