Mixedbread

Update Store

Update a store by ID or name.

PUT
/v1/stores/{store_identifier}

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

Api key to access Mixedbreads API

Path Parameters

store_identifier*|

The ID or name of the store

Request Body

application/json
  1. body

The fields to update

name?|

New name for the store. Can only contain lowercase letters, numbers, periods (.), and hyphens (-).

description?|

New description

is_public?|

Whether the store can be accessed by anyone with valid login credentials

license?|

License for public stores

expires_after?|

Optional expiration policy

metadata?|

Optional metadata key-value pairs

tags?array<string>|

New tags for the store, replacing the current ones. Send an empty list to clear.

Response Body

The details of the updated store

application/json
  1. response

Model representing a store with its metadata and timestamps.

id*Id

Unique identifier for the store

name*Name

Name of the store

Length1 <= length <= 128
description?|

Detailed description of the store's purpose and contents

is_public?Is Public

Whether the store can be accessed by anyone with valid login credentials

Defaultfalse
license?|

License for public stores

metadata?|

Additional metadata associated with the store

tags?array<string>

Tags for organizing stores

config?|

Store-level configuration defaults

bucket_id?|

Customer bucket backing this store's storage; null = platform default

file_counts?

Counts of files in different states

expires_after?|

Optional expiration policy

status?StoreStatus

Processing status of the store

Default"completed"
Value in"expired""in_progress""completed""failed"
created_at*Created At

Timestamp when the store was created

Formatdate-time
updated_at*Updated At

Timestamp when the store was last updated

Formatdate-time
last_active_at?|

Timestamp when the store was last used

usage_bytes?Usage Bytes

Total storage usage in bytes

Default0
usage_tokens?Usage Tokens

Total storage usage in tokens

Default0
expires_at?|

Optional expiration timestamp for the store

copy_state?|

Set while the store is being copied from or into, and when a copy into it failed

object?Object

Type of the object

Default"store"
from mixedbread import Mixedbreadmxbai = 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)
{  "id": "vs_abc123",  "object": "store",  "name": "updated-knowledge-base",  "description": "Updated product documentation and FAQs",  "is_public": false,  "metadata": {    "version": "2.0"  },  "tags": [],  "config": {    "contextualization": {      "with_metadata": false,      "with_file_context": false    }  },  "file_counts": {    "in_progress": 0,    "completed": 5,    "failed": 0,    "cancelled": 0,    "pending": 0,    "total": 5  },  "status": "completed",  "usage_bytes": 1048576,  "usage_tokens": 51200,  "expires_after": null,  "expires_at": null,  "created_at": "2025-01-15T10:30:00.000Z",  "updated_at": "2025-01-15T15:00:00.000Z",  "last_active_at": "2025-01-15T15:00:00.000Z"}