Skip to main content

Endpoint

POST /v1/memory/bulk

Request Body

{
  "memories": [
    {
      "type": "semantic",
      "key": "facts/item-1",
      "content": "First memory",
      "importance": 0.8,
      "expiresIn": "30d",
      "metadata": { "tags": ["batch"], "visibility": "share" }
    },
    {
      "type": "episodic",
      "key": "events/item-2",
      "content": "Second memory",
      "expiresIn": "7d"
    }
  ]
}
Maximum 20 items per request. Each item follows the same schema as Store Memory.

Response (201)

{
  "total": 2,
  "succeeded": 2,
  "failed": 0,
  "results": [
    { "success": true, "id": "...", "key": "facts/item-1" },
    { "success": true, "id": "...", "key": "events/item-2" }
  ]
}
Partial failures are possible — some items may succeed while others fail.

Credit Cost

Each item costs 5 credits (bulk.write). A request with 10 items costs 50 credits total.