Add File to Vector Store
POST/v1/vector_stores/{vector_store_identifier}/files
Authorization
Authorizationstringrequired
Bearer token for API authentication. Format: `Bearer YOUR_API_KEY`
Path Parameters
vector_store_identifierstringrequired
The ID or name of the vector 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
VectorStoreFileStatus
Possible values
pendingin_progresscancelledcompletedfailedlast_errorobject
Last error message if processing failed
vector_store_idstringrequired
ID of the containing vector store
created_atstring(date-time)required
Timestamp of vector store file creation
versioninteger
Version number of the file
usage_bytesinteger
Storage usage in bytes
objectstringdefault:
vector_store.fileType of the object
Get Vector Store File
Get details of a specific file in a vector store.
Delete Vector Store File
Delete a file from a vector store.
Last updated: August 19, 2025