release: 1.22.0

[stainless-app]

Automated Release PR

1.22.0 (2026-05-13)

Full Changelog: v1.21.0...v1.22.0

Features

• internal/types: support eagerly validating pydantic iterators (04e4187)
• support setting headers via env (30a033a)

Bug Fixes

• client: add missing f-string prefix in file type error message (ab34d42)
• client: preserve hardcoded query params when merging with user params (987fbc7)
• ensure file data are only sent as 1 parameter (a7c0bac)
• use correct field name format for multipart file arrays (c335429)

Performance Improvements

• client: optimize file structure copying in multipart requests (ea9d673)

Chores

• internal: more robust bootstrap script (2291709)
• internal: reformat pyproject.toml (acc97d1)
• tests: bump steady to v0.22.1 (02f10ea)

---

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

[cursor]

PR Summary

Medium Risk
Medium risk because it changes request construction (query param merging), multipart file extraction/field naming, and introduces new Pydantic v2 validation behavior that could affect serialization and upload compatibility.

Overview
Bumps the SDK to 1.22.0 and updates release metadata, including the OpenAPI spec pointer and changelog.

Client/request behavior changes: preserves query parameters embedded directly in request URLs when merging with user-supplied params, and adds support for injecting default headers via the LUMAAI_CUSTOM_HEADERS environment variable.

Multipart/file handling improvements: fixes file-type error messaging, enhances extract_files to control emitted multipart field names for arrays via an array_format option (including correct handling of top-level file arrays), and adds deepcopy_with_paths to avoid mutating user data while minimizing copies.

Model/type updates: introduces EagerIterable (Pydantic v2) to eagerly consume/validate iterables to avoid iterator consumption bugs during repeated serialization. CI workflows also pin GitHub Actions revisions and test tooling bumps @stdy/cli to 0.22.1.

^{Reviewed by Cursor Bugbot for commit 215a2ab. 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/luma_ai-python/e1f8d07810756d5bfa601000302fafcb0fb05057/lumaai-1.21.0-py3-none-any.whl'

Expires at: Fri, 12 Jun 2026 03:01:48 GMT
Updated at: Wed, 13 May 2026 03:01:48 GMT