Mixedbread

Vector Store Management

Vector stores transform any data into AI-native search engines that understand meaning, not just keywords. They act as containers for your files, automatically generating embeddings and enabling advanced search capabilities. Use these commands to create, manage, and organize your vector stores. Learn more about vector stores in the .

List Vector Stores

Command

mxbai vs list [options]

Options

  • --filter <name> - Filter by name pattern
  • --limit <n> - Limit number of results

Examples

# List all vector stores
mxbai vs list

# Filter vector stores by name
mxbai vs list --filter "docs"

# Limit results
mxbai vs list --limit 5

Create Vector Store

Command

mxbai vs create <name> [options]

Options

  • --description <desc> - Description for the vector store
  • --expires-after <days> - Auto-delete after specified days
  • --metadata <json> - JSON metadata for the vector store

Examples

# Create a basic vector store
mxbai vs create "My Documents"

# Create with description
mxbai vs create "My Documents" --description "Project documentation"

# Create with expiration
mxbai vs create "Temp Store" --expires-after 30

# Create with metadata
mxbai vs create "Project Store" --metadata '{"project": "web-app", "team": "engineering"}'

Get Vector Store Details

Command

mxbai vs get <name-or-id>

Options

None

Examples

# Get vector store by name
mxbai vs get "My Documents"

# Get vector store by ID
mxbai vs get vs_abc123

Update Vector Store

Command

mxbai vs update <name-or-id> [options]

Options

  • --name <name> - New name for the vector store
  • --description <desc> - New description
  • --expires-after <days> - Update expiration
  • --metadata <json> - Update metadata

Examples

# Update description
mxbai vs update "My Documents" --description "Updated description"

# Rename vector store
mxbai vs update "Old Name" --name "New Name"

# Update metadata
mxbai vs update "My Store" --metadata '{"version": "2.0"}'

Delete Vector Store

Command

mxbai vs delete <name-or-id> [options]

Alias: mxbai vs rm <name-or-id>

Options

  • --force - Skip confirmation prompt

Examples

# Delete with confirmation prompt
mxbai vs delete "My Documents"

# Delete without confirmation
mxbai vs delete "My Documents" --force

# Delete using alias
mxbai vs rm "My Documents" --force

# Delete by ID
mxbai vs delete vs_abc123 --force
Configuration
Manage CLI settings, defaults, and aliases to customize your mxbai experience.
File Management
Upload files and manage files within vector stores.

Last updated: July 5, 2025