release: 0.51.0

[stainless-app]

Automated Release PR

0.51.0 (2026-05-09)

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

Features

• api: api update (eac4b8f)
• api: api update (66aa7dc)
• 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
Adjusts request construction for multipart file uploads and introduces env-driven default headers, which can change HTTP behavior across all client calls. Version bump and type additions are low risk, but serialization/header changes warrant extra review.

Overview
Bumps the SDK to v0.51.0 (manifest, pyproject.toml, src/mixedbread/_version.py) and updates release metadata/changelog.

Adds support for configuring default request headers via the MIXEDBREAD_CUSTOM_HEADERS environment variable (sync + async clients), merging parsed headers into default_headers.

Fixes multipart file extraction to emit correct field names for file arrays by making extract_files(..., array_format=...) control whether keys use [], indices ([0]), or bare repeat/comma forms, with expanded tests.

Moves ArrayFormat/NestedFormat type aliases into _types for reuse and extends AgenticSearchConfigParam with new strict_top_k and multimodal options; also fixes a missing f-string in an async file error message.

^{Reviewed by Cursor Bugbot for commit 80c8f55. 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/fe74792cd81bb58bd62e58c086d6d1ee6c233c25/mixedbread-0.50.0-py3-none-any.whl'

Expires at: Mon, 08 Jun 2026 03:39:25 GMT
Updated at: Sat, 09 May 2026 03:39:25 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.