Mixedbread

Create Store

POST/v1/stores

Authorization

Authorizationstringrequired

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

Request Body

namestring

Name for the new store

Constraints

•Minimum length: 1
descriptionstring

Description of the store

is_publicbooleandefault: false

Whether the 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 store

namestringrequired

Name of the store

Constraints

•Minimum length: 1•Maximum length: 100
descriptionstring

Detailed description of the store's purpose and contents

is_publicbooleandefault: false

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

metadataobject

Additional metadata associated with the store

expires_afterExpiresAfter

Optional expiration policy

statusenum

Status of a store.

Possible values

expiredin_progresscompleted
created_atstring(date-time)required

Timestamp when the store was created

updated_atstring(date-time)required

Timestamp when the store was last updated

last_active_atstring

Timestamp when the store was last used

usage_bytesintegerdefault: 0

Total storage usage in bytes

expires_atstring

Optional expiration timestamp for the store

objectstringdefault: store

Type of the object

Last updated: October 6, 2025