API Reference
Memories · Bulk write
POST /api/v1/memories/bulk — write many memories in one request.
Embedding defers by default on this path. Items written without a vector come
back with metadata.embedding_pending: true, and until it clears they are
reachable by keyword and by the non-semantic list, but do not compete on
semantic similarity — so a paraphrase search can miss a memory an exact-words
search finds.
Authorization
APIKeyHeader X-API-Key<token>
In: header
Header Parameters
Idempotency-Key?string|null
X-Bulk-Attempt-Id?string|null
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://loading/api/v1/memories/bulk" \ -H "Content-Type: application/json" \ -d '{ "tenant_id": "string", "items": [ { "content": "string" } ] }'{
"created": 0,
"duplicates": 0,
"errors": 0,
"results": [
{
"index": 0,
"client_request_id": "string",
"status": "created",
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"duplicate_of": "15a4136f-d85d-4645-ade9-a6c6085b348c",
"error": "string"
}
],
"bulk_ms": 0
}{
"created": 0,
"duplicates": 0,
"errors": 0,
"results": [
{
"index": 0,
"client_request_id": "string",
"status": "created",
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"duplicate_of": "15a4136f-d85d-4645-ade9-a6c6085b348c",
"error": "string"
}
],
"bulk_ms": 0
}{
"detail": "string",
"error": {
"code": "string",
"message": "string",
"details": {}
}
}{
"detail": "string",
"error": {
"code": "string",
"message": "string",
"details": {}
}
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}