Sign in

v1

latestOpenAPI 3.1.0MIT2026-07-132429592.7 MB
Vector stores

Create a vector store file batch.

The maximum number of files in a single batch request is 2000. Vector store file attach requests are rate limited per vector store (300 requests per minute across both this endpoint and /vector_stores/{vector_store_id}/files). For ingesting multiple files into the same vector store, this batch endpoint is recommended.

post/vector_stores/{vector_store_id}/file_batches

Path parameters

vector_store_idstring required
Example:vs_abc123

The ID of the vector store for which to create a File Batch.

Request body

OR

Response

OK

idstring required

The identifier, which can be referenced in API endpoints.

object'vector_store.files_batch' required

The object type, which is always vector_store.file_batch.

created_atinteger required

The Unix timestamp (in seconds) for when the vector store files batch was created.

vector_store_idstring required

The ID of the vector store that the File is attached to.

status'in_progress' | 'completed' | 'cancelled' | 'failed' required

The status of the vector store files batch, which can be either in_progress, completed, cancelled or failed.