API Reference
Vectors
Direct Turbopuffer-backed vector operations.
Direct vector operations for custom embeddings or external embedding services, bypassing the document ingestion pipeline.
Scoped API keys need vector:write for upsert and vector:delete for delete. collection:write no longer grants raw vector mutation.
Example: Custom Embeddings
# Upsert vectors with your own embeddings
curl -X POST http://localhost:4000/v1/collections/custom/vectors/upsert \
-H "Authorization: Bearer $BIGRAG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"vectors": [
{
"id": "vec_001",
"embedding": [0.1, 0.2, 0.3],
"text": "Custom content",
"metadata": {"source": "external"}
}
]
}'
# Delete vectors
curl -X POST http://localhost:4000/v1/collections/custom/vectors/delete \
-H "Authorization: Bearer $BIGRAG_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ids": ["vec_001"]}'The embedding dimension must match the collection's configured dimension. Request vectors with the wrong dimension return 400; an existing Turbopuffer namespace with a different dimension returns 409.