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 StoreLink to section

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 StoreLink to section

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 StoresLink to section

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 StoreLink to section

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.