--- title: "[DEPRECATED] List store files" method: GET path: "/v1/stores/{store_identifier}/files" tags: ["stores"] deprecated: true --- # \[DEPRECATED\] List store files `GET /v1/stores/{store_identifier}/files` > **Deprecated.** DEPRECATED: Use POST /stores/{store_identifier}/files/list instead ## Path parameters - `store_identifier` union, required — The ID or name of the store - string - string, uuid ## Query parameters - `limit` integer — Maximum number of items to return per page (1-100) - `after` string, nullable — Cursor for forward pagination - get items after this position. Use last_cursor from previous response. - `before` string, nullable — Cursor for backward pagination - get items before this position. Use first_cursor from previous response. - `include_total` boolean — Whether to include total count in response (expensive operation) - `sort_by` 'created_at' | 'filename' | 'usage_bytes' | 'usage_tokens' — Field to order the files by - `sort_order` 'asc' | 'desc' — Direction of the sort - `statuses` JobStatus[], nullable — Status to filter by ## Response `200` The list of store files - StoreFileListResponse - `pagination` CursorPaginationResponse, required — Response model for cursor-based pagination. - `has_more` boolean, required — Contextual direction-aware flag: True if more items exist in the requested pagination direction. For 'after': more items after this page. For 'before': more items before this page. - `first_cursor` string, nullable, required — Cursor of the first item in this page. Use for backward pagination. None if page is empty. - `last_cursor` string, nullable, required — Cursor of the last item in this page. Use for forward pagination. None if page is empty. - `total` integer, nullable — Total number of items available across all pages. Only included when include_total=true was requested. Expensive operation - use sparingly. - `object` 'list' — The object type of the response - `data` StoreFile[], required — The list of store files - `id` string, required — Unique identifier for the file - `filename` string — Name of the file - `metadata` unknown - `external_id` string, nullable — External identifier for this file in the store - `status` 'pending' | 'in_progress' | 'cancelled' | 'completed' | 'failed' — The lifecycle of a unit of background work. One vocabulary for every job family. The database keeps a separate enum type per table (``parsing_job_status``, ``store_file_status``, ...) but they all carry these values, so the aliases below are this enum rather than copies of it. :class:`SyncStatus` is this set plus ``IDLE`` for connectors, which have a resting state between runs. - `last_error` unknown - `store_id` string, required — ID of the containing store - `created_at` string, date-time, required — Timestamp of store file creation - `version` integer, nullable — Version number of the file - `usage_bytes` integer, nullable — Storage usage in bytes - `usage_tokens` integer, nullable — Storage usage in tokens - `config` StoreFileConfig — Configuration for a file. - `parsing_strategy` 'fast' | 'high_quality' — Strategy for adding a file to a store. - `object` 'store.file' — Type of the object - `chunks` union[], nullable — chunks - union - TextInputChunk - `chunk_index` integer, required — position of the chunk in a file - `mime_type` string — mime type of the chunk - `generated_metadata` union — metadata of the chunk - MarkdownChunkGeneratedMetadata - … - TextChunkGeneratedMetadata - … - CsvChunkGeneratedMetadata - … - PDFChunkGeneratedMetadata - … - CodeChunkGeneratedMetadata - … - AudioChunkGeneratedMetadata - … - VideoChunkGeneratedMetadata - … - ImageChunkGeneratedMetadata - … - `model` string, nullable — model used for this chunk - `type` 'text' — Input type identifier - `offset` integer — The offset of the text in the file relative to the start of the file. - `text` string, nullable — Text content - `context` string, nullable — LLM-generated context that situates this chunk within its source document - `summary` string, nullable — summary of the text chunk - ImageUrlInputChunk - `chunk_index` integer, required — position of the chunk in a file - `mime_type` string — mime type of the chunk - `generated_metadata` union — metadata of the chunk - MarkdownChunkGeneratedMetadata - … - TextChunkGeneratedMetadata - … - CsvChunkGeneratedMetadata - … - PDFChunkGeneratedMetadata - … - CodeChunkGeneratedMetadata - … - AudioChunkGeneratedMetadata - … - VideoChunkGeneratedMetadata - … - ImageChunkGeneratedMetadata - … - `model` string, nullable — model used for this chunk - `type` 'image_url' — Input type identifier - `ocr_text` string, nullable — ocr text of the image - `context` string, nullable — LLM-generated context that situates this image within its source document - `summary` string, nullable — summary of the image - `image_url` ImageUrlOutput — Model for image URL validation. - `url` string, required — The image URL. Can be either a URL or a Data URI. - `format` string — The image format/mimetype - AudioUrlInputChunk - `chunk_index` integer, required — position of the chunk in a file - `mime_type` string — mime type of the chunk - `generated_metadata` union — metadata of the chunk - MarkdownChunkGeneratedMetadata - … - TextChunkGeneratedMetadata - … - CsvChunkGeneratedMetadata - … - PDFChunkGeneratedMetadata - … - CodeChunkGeneratedMetadata - … - AudioChunkGeneratedMetadata - … - VideoChunkGeneratedMetadata - … - ImageChunkGeneratedMetadata - … - `model` string, nullable — model used for this chunk - `type` 'audio_url' — Input type identifier - `transcription` string, nullable — speech recognition (sr) text of the audio - `context` string, nullable — LLM-generated context that situates this audio chunk within its source file - `summary` string, nullable — summary of the audio - `audio_url` AudioUrl — Model for audio URL validation. - `url` string, required — The audio URL. Can be either a URL or a Data URI. - `sampling_rate` integer, required — The sampling rate of the audio. - VideoUrlInputChunk - `chunk_index` integer, required — position of the chunk in a file - `mime_type` string — mime type of the chunk - `generated_metadata` union — metadata of the chunk - MarkdownChunkGeneratedMetadata - … - TextChunkGeneratedMetadata - … - CsvChunkGeneratedMetadata - … - PDFChunkGeneratedMetadata - … - CodeChunkGeneratedMetadata - … - AudioChunkGeneratedMetadata - … - VideoChunkGeneratedMetadata - … - ImageChunkGeneratedMetadata - … - `model` string, nullable — model used for this chunk - `type` 'video_url' — Input type identifier - `transcription` string, nullable — speech recognition (sr) text of the video - `context` string, nullable — LLM-generated context that situates this video chunk within its source file - `summary` string, nullable — summary of the video - `video_url` VideoUrl — Model for video URL validation. - `url` string, required — The video URL. Can be either a URL or a Data URI. - `content_url` string, required — Presigned URL for file content ## Other responses - `422` — Validation Error ## Changes - **2026-09-18** `427a5c58f68a` — 2 info - added the new optional `query` request parameter `sort_by` - added the new optional `query` request parameter `sort_order` - **2026-09-15** `957bf8ec8df8` — 4 breaking, 4 info - added `#/components/schemas/CsvChunkGeneratedMetadata` to the `data/items/chunks/anyOf[subschema #1]/items/oneOf[subschema #1: TextInputChunk]/generated_metadata/anyOf[subschema #1]/` response property `oneOf` list for the response status `200` - added `#/components/schemas/CsvChunkGeneratedMetadata` to the `data/items/chunks/anyOf[subschema #1]/items/oneOf[subschema #2: ImageUrlInputChunk]/generated_metadata/anyOf[subschema #1]/` response property `oneOf` list for the response status `200` - added `#/components/schemas/CsvChunkGeneratedMetadata` to the `data/items/chunks/anyOf[subschema #1]/items/oneOf[subschema #3: AudioUrlInputChunk]/generated_metadata/anyOf[subschema #1]/` response property `oneOf` list for the response status `200` - added `#/components/schemas/CsvChunkGeneratedMetadata` to the `data/items/chunks/anyOf[subschema #1]/items/oneOf[subschema #4: VideoUrlInputChunk]/generated_metadata/anyOf[subschema #1]/` response property `oneOf` list for the response status `200` - …4 more - …earlier changes not shown [Full history](https://skmtc.dev/mixedbread/apis/mxbai-omni/changes/v1/stores/:store_identifier/files/get.md) --- [API](https://skmtc.dev/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.dev/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc.dev/mixedbread/apis/mxbai-omni/revisions/427a5c58f68a?raw)