Sign in

v5

OpenAPI 3.1.02026-08-025631,1012.8 MB
BYO Documents

Upsert documents with BYO vectors

Upsert documents with user-provided vectors directly into a namespace. This bypasses the collection/batch/extractor pipeline entirely. Documents go directly to the vector store. Maximum 1000 documents per call.

post/v1/namespaces/{namespace_id}/documents/upsert

Path parameters

namespace_idstring required

The namespace to upsert documents into.

Example:ns_abc123def456

The namespace to upsert documents into.

Request body

collection_idstring nullable

Target collection. Documents are tagged with this collection_id so they appear in collection-scoped queries, list, and clustering. When omitted a namespace-level default collection is used.

Response

Successful Response

insertedinteger required

Number of documents upserted.

document_idsstring[] required

IDs of all upserted documents.

write_tokenstring nullable

Opaque token for read-your-writes consistency (only when requested).