release: 0.51.0

[stainless-app]

Automated Release PR

0.51.0 (2026-05-20)

Full Changelog: v0.50.0...v0.51.0

Features

• api: api update (c59f556)
• api: api update (842efa8)
• api: api update (6fe066e)
• api: api update (eac4b8f)
• api: api update (66aa7dc)
• internal/types: support eagerly validating pydantic iterators (3e9c5ac)
• support setting headers via env (38de0ee)

Bug Fixes

• client: add missing f-string prefix in file type error message (fe74792)
• use correct field name format for multipart file arrays (361fcd6)

Chores

• internal: reformat pyproject.toml (8802c53)

---

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions

---

Note

Medium Risk
Medium risk because it changes request construction/serialization details (multipart file field naming, default headers via env) and adjusts Pydantic v2 validation/extra-field handling, which could impact API compatibility at runtime.

Overview
Releases v0.51.0 with regenerated API surface/types, including new store facet limits (max_fields, max_values_per_field, max_files), expanded AgenticSearchConfigParam, and added summary fields for audio chunks.

Improves client/runtime behavior by allowing default request headers to be injected via MIXEDBREAD_CUSTOM_HEADERS, adding EagerIterable to eagerly validate/serialize Pydantic v2 iterables safely, and fixing multipart file-array key formatting by making extract_files(..., array_format=...) control emitted field names.

Cleans up generated types by removing SearchFilter exports/definitions in favor of inline typed filter inputs, adds a Pydantic compatibility workaround for StoreSearchResponse extra fields, and updates tests accordingly; CI workflows now pin actions/checkout/actions/github-script SHAs and version files/changelog are bumped.

^{Reviewed by Cursor Bugbot for commit eb32b77. Bugbot is set up for automated code reviews on this repo. Configure here.}

[stainless-app]

🧪 Testing

To try out this version of the SDK:

pip install 'https://pkg.stainless.com/s/mixedbread-python/c59f5561b5e782ae7e35b9cbfb498f357856c8f8/mixedbread-0.50.0-py3-none-any.whl'

Expires at: Mon, 15 Jun 2026 02:23:17 GMT
Updated at: Sat, 16 May 2026 02:23:17 GMT

[cursor]

You have used all of your free Bugbot PR reviews.

To receive reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

[stainless-app]

🤖 Release is at https://github.com/mixedbread-ai/mixedbread-python/releases/tag/v0.51.0 🌻