Mixedbread

Add File to Store

POST/v1/stores/{store_identifier}/files

Authorization

Authorizationstringrequired

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

Path Parameters

store_identifierstringrequired

The ID or name of the store

Request Body

file_idstring(uuid)required

ID of the file to add

metadataobject

Optional metadata for the file

Response Body

idstringrequired

Unique identifier for the file

filenamestring

Name of the file

metadataobject

Optional file metadata

statusenum

StoreFileStatus

Possible values

pendingin_progresscancelledcompletedfailed
last_errorobject

Last error message if processing failed

store_idstringrequired

ID of the containing store

created_atstring(date-time)required

Timestamp of store file creation

versioninteger

Version number of the file

usage_bytesinteger

Storage usage in bytes

objectstringdefault: store.file

Type of the object

Last updated: October 6, 2025