Manage Stores

Once you've created Stores, you can manage them using these core operations. All operations work with either the Store ID or the unique name you assigned.

Retrieve Store

Get details about a specific Store:

from mixedbread import Mixedbread

mxbai = Mixedbread(api_key="YOUR_API_KEY")

store = mxbai.stores.retrieve(store_identifier="my-knowledge-base")

print(store)

This returns a complete Store object with all properties including file counts, status, and usage statistics. For details on all returned fields, see Data Models.

Update Store

Modify an existing Store's configuration:

from mixedbread import Mixedbread

mxbai = Mixedbread(api_key="YOUR_API_KEY")

store = mxbai.stores.update(
    store_identifier="my-knowledge-base",
    name="updated-knowledge-base",
    description="Updated product documentation and FAQs",
    metadata={"version": "2.0"},
)

print(store)

Updatable Properties:

• name: Change the unique identifier (lowercase letters, numbers, periods, and hyphens only)
• description: Update the description
• is_public: Change visibility (public/private)
• expires_after: Modify or remove expiration policy

List Stores

Get all Stores in your organization. The list operation uses cursor-based pagination:

from mixedbread import Mixedbread

mxbai = Mixedbread(api_key="YOUR_API_KEY")

response = mxbai.stores.list(limit=20)

for store in response.data:
    print(store)

Delete Store

Permanently remove a Store and all its contents:

from mixedbread import Mixedbread

mxbai = Mixedbread(api_key="YOUR_API_KEY")

response = mxbai.stores.delete(store_identifier="my-knowledge-base")

print(response)

Important: Deletion is permanent and cannot be undone. All files, embeddings, and metadata are permanently removed.