Sign in

v5

latestOpenAPI 3.1.02026-08-04166362486.5 KB
stores

Update store file metadata

Update metadata on a file within a store.

Args: store_identifier: The ID or name of the store. file_identifier: The ID or name of the file to update. update_params: Metadata update payload.

Returns: StoreFile: The updated file details.

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

Path parameters

string required
OR
string uuid required

The ID or name of the store

string required
OR
string uuid required

The ID or name of the file to update

Request body

metadataobject nullable

Updated metadata for the file

Response

The updated store file details

idstring required

Unique identifier for the file

filenamestring

Name of the file

{"stackTrail":"components:schemas:StoreFile:properties:metadata:anyOf","oasType":"schema","type":"unknown","title":"Metadata","description":"Optional file metadata","nullable":true}
external_idstring nullable

External identifier for this file in the store

status'pending' | 'in_progress' | 'cancelled' | 'completed' | 'failed'
{"stackTrail":"components:schemas:StoreFile:properties:last_error:anyOf","oasType":"schema","type":"unknown","title":"Last Error","description":"Last error message if processing failed","nullable":true}
store_idstring required

ID of the containing store

created_atstring date-time required

Timestamp of store file creation

versioninteger nullable

Version number of the file

usage_bytesinteger nullable

Storage usage in bytes

usage_tokensinteger nullable

Storage usage in tokens

object'store.file'

Type of the object

content_urlstring required

Presigned URL for file content

Example response

{
  "version": 1,
  "usage_bytes": 51200,
  "usage_tokens": 51200,
  "chunks": [
    {
      "mime_type": "text/plain",
      "model": "text-embedding-ada-002",
      "context": "This chunk is from an SEC filing on ACME corp's Q2 2023 performance.",
      "summary": "A short overview of ACME's Q2 2023 performance."
    }
  ]
}