File Management
Files serve as the foundation for all content processing workflows in Mixedbread. They provide secure upload, storage, and retrieval of documents with support for various file types including PDFs, images, and structured data. Manage files within your vector stores with version management, metadata support, and unique ID referencing.
Upload Files
Command
Options
--strategy fast|high_quality
- Processing strategy (default:fast
)--contextualization
- Enable context preservation (default:false
)--metadata <json>
- JSON metadata for uploaded files--dry-run
- Preview what would be uploaded without uploading--parallel <n>
- Number of concurrent uploads (default:5
, range:1
-20
)--unique
- Update existing files instead of creating duplicates--manifest <file>
- Upload using manifest file
Manifest File Format
The manifest file allows you to define complex upload configurations with different settings for different file patterns. Both JSON (.json
) and YAML (.yaml
or .yml
) formats are supported.
JSON format:
YAML format:
Manifest properties:
version
- Manifest format version (currently "1.0")defaults
- Default settings applied to all filesstrategy
- Default processing strategycontextualization
- Default context preservation settingmetadata
- Default metadata for all files
files
- Array of file upload configurationspath
- Glob pattern for files to uploadstrategy
- Specific strategy for this patterncontextualization
- Specific contextualization for this patternmetadata
- Additional metadata for this pattern (merged with defaults)
Examples
Upload Summary Information
The upload command displays strategy and contextualization information in different formats:
Normal Uploads
Show configuration in the summary after completion:
Manifest Uploads
Show configuration beside each file as it's processed:
This allows you to see exactly which strategy and contextualization settings were applied to each file, making it easy to verify that your manifest configuration is working as expected.
List Files
Command
Alias: mxbai vs files ls <name-or-id>
Options
--status <status>
- Filter by status: pending, in_progress, cancelled, completed, failed--limit <n>
- Limit number of results
Examples
Get File Details
Command
Options
None
Examples
Delete File
Command
Alias: mxbai vs files rm <name-or-id> <file-id>
Options
--force
- Skip confirmation prompt
Examples
Last updated: July 5, 2025