Encrypted Index
Upsert Vectors (Binary)
POST
Upsert Vectors (Binary)
Add new vectors or update existing ones in the encrypted index using a binary-encoded format for more efficient transfer of large batches.
Any valid credential is accepted — the root key or a per-user
With Auto-Training Triggered:
With Training Check Warning:
Authentication
Required - API key viaX-API-Key header:
cdbk_ token. When RBAC is not enabled (CYBORGDB_SERVICE_ROOT_KEY unset), no header is required.
Request Body
Response
In rare cases where the training check encounters an error but the upsert operation itself succeeds, a
warning field will be included instead. The vectors are still successfully upserted in this scenario.Exceptions
400 Bad Request
400 Bad Request
Invalid values (e.g. vector dimension mismatch with the index)
404 Not Found
404 Not Found
Index not found
422 Unprocessable Entity
422 Unprocessable Entity
Request body failed validation (missing/mistyped fields)
500 Internal Server Error
500 Internal Server Error
Internal server error