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

external_idstring

Optional external identifier for the file. Can be used to reference the file in subsequent operations. Supports slashes for path-like identifiers (e.g., 'docs/api/auth.md')

overwritebooleandefault: true

Whether to overwrite an existing file with the same external_id

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