Update Store File

PATCH/v1/stores/{store_identifier}/files/{file_identifier}

AuthorizationLink to section

Authorizationstringrequired

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

Path ParametersLink to section

store_identifierstringrequired

The ID or name of the store

file_identifierstringrequired

The ID or external_id of the file to update. Supports slashes for path-like identifiers.

Request BodyLink to section

metadataobject

Updated metadata for the file. Pass `null` to clear existing metadata.

Response BodyLink to section

idstringrequired

Unique identifier for the file

filenamestring

Name of the file

metadataobject

Optional file metadata

external_idstring

External identifier for this file in the store

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

usage_tokensinteger

Storage usage in tokens

objectstringdefault: store.file

Type of the object

content_urlstringrequired

Presigned URL for file content

Request

PATCH/v1/stores/{store_identifier}/files/{file_identifier}

from mixedbread import Mixedbread

mxbai = Mixedbread(api_key="YOUR_API_KEY")

file = mxbai.stores.files.update(
    store_identifier="my-knowledge-base",
    file_identifier="f47ac10b-58cc-4372-a567-0e02b2c3d479",
    metadata={"category": "documentation"},
)

print(file)

Response

JSON

{
  "id": "{{FILE_ID}}",
  "external_id": "ext-doc-001",
  "object": "store.file",
  "filename": "example_document.pdf",
  "metadata": {
    "category": "documentation"
  },
  "status": "completed",
  "last_error": null,
  "store_id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
  "usage_bytes": 1048576,
  "usage_tokens": 51200,
  "config": {
    "parsing_strategy": "fast"
  },
  "version": 1,
  "created_at": "2025-01-15T16:00:00.000Z",
  "content_url": "https://example.com/files/{{FILE_ID}}?signature=..."
}