Mixedbread

Create Vector Store

POST/v1/vector_stores

Authorization

Authorizationstringrequired

Bearer token for API authentication. Format: `Bearer YOUR_API_KEY`

Request Body

namestring

Name for the new vector store

Constraints

Minimum length: 1
descriptionstring

Description of the vector store

is_publicbooleandefault: false

Whether the vector store can be accessed by anyone with valid login credentials

expires_afterExpiresAfter

Optional expiration policy

metadataobject

Optional metadata key-value pairs

file_idsarray

Optional list of file IDs

Response Body

idstringrequired

Unique identifier for the vector store

namestringrequired

Name of the vector store

Constraints

Minimum length: 1Maximum length: 100
descriptionstring

Detailed description of the vector store's purpose and contents

is_publicbooleandefault: false

Whether the vector store can be accessed by anyone with valid login credentials

metadataobject

Additional metadata associated with the vector store

expires_afterExpiresAfter

Optional expiration policy

statusenum

Status of a vector store.

Possible values

expiredin_progresscompleted
created_atstring(date-time)required

Timestamp when the vector store was created

updated_atstring(date-time)required

Timestamp when the vector store was last updated

last_active_atstring

Timestamp when the vector store was last used

usage_bytesintegerdefault: 0

Total storage usage in bytes

expires_atstring

Optional expiration timestamp for the vector store

objectstringdefault: vector_store

Type of the object

Last updated: August 19, 2025