release: 0.57.0

[stainless-app]

Automated Release PR

0.57.0 (2026-03-04)

Full Changelog: v0.56.0...v0.57.0

Features

• also add multipart upload config to store files upload and upload and poll positional arguments (0d98943)
• api: add uploads (multipart) subresource to files (dded42d)
• api: api update (236f3f8)
• api: files uploads (multipart) subresource (a14e662)
• api: manual updates (0c90f04)
• api: manual updates (0cb6997)
• api: manual updates (aa32d0f)
• use multipart uploads API for files creation (32c0ef3)

Bug Fixes

• remove unexported type 'StoreFilesCursor' (96e3930)
• return APIPromise for create file APIs for backwards compatibility (c361cde)
• use user provided fetch for multipart uploads if provided (6c522ab)

---

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
Moderate risk because client.files.create now conditionally switches to a new multipart upload flow with concurrency, abort handling, and direct fetch PUTs to presigned URLs; this can affect upload behavior/performance and error handling for large files.

Overview
Adds a new client.files.uploads subresource (create/retrieve/list/abort/complete) and updates client.files.create to automatically use multipart uploads for large files (threshold/part size/concurrency configurable via multipartUpload, with optional per-part progress callbacks and best-effort abort on failure).

Propagates multipartUpload options through store helpers (stores.files.upload/uploadAndPoll) and relaxes VideoChunkGeneratedMetadata.file_size to be nullable/optional. Includes new unit tests for the multipart upload helper and resource tests for the uploads endpoints, plus a version bump to 0.57.0 and updated docs/changelog.

^{Written by Cursor Bugbot for commit e7eebb7. This will update automatically on new commits. Configure here.}

[stainless-app]

🧪 Testing

To try out this version of the SDK:

npm install 'https://pkg.stainless.com/s/mixedbread-typescript/6c522ab9642c9efb265a6469a925ad8401a6581e/dist.tar.gz'

Expires at: Fri, 03 Apr 2026 11:22:12 GMT
Updated at: Wed, 04 Mar 2026 11:22:12 GMT

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

[stainless-app]

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