CHANGELOG.md

Changelog

1.2.0 (2026-04-18)

Full Changelog: v1.1.2...v1.2.0

Features

• internal: implement indices array format for query and form serialization (80ca975)

Bug Fixes

• client: preserve hardcoded query params when merging with user params (ff12a20)
• ensure file data are only sent as 1 parameter (f67099c)

Performance Improvements

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

Chores

• tests: bump steady to v0.20.1 (f031213)
• tests: bump steady to v0.20.2 (66e56a7)
• tests: bump steady to v0.22.1 (65e6535)

Documentation

• improve examples (9b75c4c)

1.1.2 (2026-03-25)

Full Changelog: v1.1.1...v1.1.2

Bug Fixes

• deps: bump minimum typing-extensions version (3ef90d5)
• pydantic: do not pass by_alias unless set (f84dd8c)
• sanitize endpoint path params (4e57480)

Chores

• ci: skip lint on metadata-only changes (e34867c)
• internal: tweak CI branches (5ec9308)
• internal: update gitignore (29f97bf)
• tests: bump steady to v0.19.4 (7c9854e)
• tests: bump steady to v0.19.5 (e3a0370)
• tests: bump steady to v0.19.6 (001301b)
• tests: bump steady to v0.19.7 (5419e4c)

Refactors

• tests: switch from prism to steady (491149a)

1.1.1 (2026-03-11)

Full Changelog: v1.1.0...v1.1.1

Chores

• ci: skip uploading artifacts on stainless-internal branches (1995ebc)
• docs: remove www prefix (2f429b1)
• format all api.md files (b7a0488)
• internal: add request options to SSE classes (7ffeb7c)
• internal: bump dependencies (862b60e)
• internal: codegen related update (f65774d)
• internal: fix lint error on Python 3.14 (759089a)
• internal: make test_proxy_environment_variables more resilient (2421ef6)
• internal: make test_proxy_environment_variables more resilient to env (fd9609d)
• test: do not count install time for mock server timeout (c242fb0)
• update mock server docs (6c8a563)
• update placeholder string (fb77938)

1.1.0 (2026-03-08)

Full Changelog: v1.0.0...v1.1.0

Features

• client: add custom JSON encoder for extended type support (a678f79)
• client: add support for binary request streaming (93813fd)

Bug Fixes

• use valid Python version and fix mypy lint error (#267) (5f0082a)

Chores

• ci: upgrade actions/github-script (03f1c19)
• deprecate Python 3.9 support (#264) (01190ec)
• internal: add --fix argument to lint script (2d9ebd6)
• internal: codegen related update (c074088)
• internal: codegen related update (4f6b7d0)
• internal: codegen related update (48778ff)
• internal: codegen related update (8b1aaa4)
• internal: codegen related update (17104ab)
• internal: codegen related update (a236a32)
• internal: codegen related update (544abc6)
• internal: codegen related update (ef5b5f7)
• internal: codegen related update (fbc0d70)
• internal: update actions/checkout version (a472539)

1.0.0 (2025-12-17)

Full Changelog: v0.37.1...v1.0.0

Features

• api: api update (f1f83f8)

Bug Fixes

• types: allow pyright to infer TypedDict types within SequenceNotStr (4847b77)
• use async_to_httpx_files in patch method (360421b)

Chores

• add missing docstrings (047ce99)
• internal: add missing files argument to base client (7c889d7)

0.37.1 (2025-12-04)

Full Changelog: v0.37.0...v0.37.1

Bug Fixes

• consume stream to prevent hanging (#260) (42fcb07)

Chores

• docs: use environment variables for authentication in code snippets (3ed8c12)
• update lockfile (f240076)

0.37.0 (2025-12-01)

Full Changelog: v0.36.0...v0.37.0

Features

• api: api update (5d0d829)

Bug Fixes

• always call close in the streaming generators (f19496e)
• ensure streams are always closed (ba33c5e)

Chores

• add Python 3.14 classifier and testing (26120a6)
• deps: mypy 1.18.1 has a regression, pin to 1.17 (ceaffd2)

0.36.0 (2025-11-20)

Full Changelog: v0.35.0...v0.36.0

Features

• api: api update (0287563)

Chores

• GitHub Terraform: Create/Update .github/workflows/code-freeze-bypass.yaml [skip ci] (07f6b0b)

0.35.0 (2025-11-18)

Full Changelog: v0.34.1...v0.35.0

Features

• api: api update (d6ec93d)
• api: api update (48c8f11)

Bug Fixes

• update chat completion streaming types (833cf83)

Chores

• GitHub Terraform: Create/Update .github/workflows/code-freeze-bypass.yaml [skip ci] (63d11e3)

0.34.1 (2025-11-14)

Full Changelog: v0.34.0...v0.34.1

Bug Fixes

• Add annotations to streaming response (#255) (fd2f850)

0.34.0 (2025-11-12)

Full Changelog: v0.33.0...v0.34.0

Features

• api: api update (51bb951)

Bug Fixes

• client: close streams without requiring full consumption (99b9431)
• compat with Python 3.14 (edd91d9)
• compat: update signatures of model_dump and model_dump_json for Pydantic v1 (2e981f7)

Chores

• internal/tests: avoid race condition with implicit client cleanup (3af43e5)
• internal: grammar fix (it's -> its) (37687bf)
• package: drop Python 3.8 support (e45cc65)

0.33.0 (2025-10-21)

Full Changelog: v0.32.0...v0.33.0

Features

• api: api update (e3ef279)
• api: api update (dba73cd)
• api: api update (0008a45)
• api: api update (b9e85a0)

Bug Fixes

• bad merge (1d66042)
• completions overloads (cf9ad41)

Chores

• bump httpx-aiohttp version to 0.1.9 (f366ae8)
• do not install brew dependencies in ./scripts/bootstrap by default (77febdb)
• internal: detect missing future annotations with ruff (b25a9a9)
• types: change optional parameter type from NotGiven to Omit (437d52b)

0.32.0 (2025-09-27)

Full Changelog: v0.31.1...v0.32.0

Features

• api: api update (5d3f1db)
• api: api update (5b48116)

Bug Fixes

• chat stream overloads (42f9396)
• GitHub Terraform: Create/Update .github/workflows/stale.yaml [skip ci] (ba00a6e)

Chores

• internal: move mypy configurations to pyproject.toml file (a8113a5)
• internal: update pydantic dependency (0d8773d)
• tests: simplify get_platform test (a257487)
• types: change optional parameter type from NotGiven to Omit (882ffc0)

0.31.1 (2025-09-04)

Full Changelog: v0.31.0...v0.31.1

Features

• api: api update (0a8a5c0)
• api: api update (7896dbd)
• api: api update (f9b5dca)
• api: api update (e34ec28)
• api: api update (cd14d0a)
• api: api update (7d02cd3)
• api: api update (437f5fb)
• improve future compat with pydantic v3 (42a6cb9)
• types: replace List[str] with SequenceNotStr in params (d1ee744)

Bug Fixes

• avoid newer type syntax (21f93a7)
• compeltions streaming overloads (201e137)
• update example model from decommissioned models to gpt-oss-20b (1570583)
• update example model from decommissioned models to gpt-oss-20b (#250) (edb9132)

Chores

• internal: add Sequence related utils (01104d8)
• internal: change ci workflow machines (e796cb9)
• internal: fix ruff target version (b58149d)
• internal: update comment in script (bd20c49)
• internal: update pyright exclude list (124e838)
• update @stainless-api/prism-cli to v5.15.0 (b2f49cc)
• update github action (c7662e0)

0.31.0 (2025-08-05)

Full Changelog: v0.30.0...v0.31.0

Features

• api: api update (be81724)
• api: api update (bd9eafd)
• api: api update (86eab4f)
• api: api update (4068695)
• api: api update (5c45441)
• api: api update (30646f2)
• api: api update (e8ede14)
• api: api update (3c06879)
• api: api update (455c74a)
• clean up environment call outs (0627bc6)
• client: support file upload requests (0f2d5a7)

Bug Fixes

• client: don't send Content-Type header on GET requests (7439911)
• parsing: ignore empty metadata (eccd423)
• parsing: parse extra field types (590a947)
• streaming overrides (ff828d6)

Chores

• project: add settings file for vscode (938789a)

0.30.0 (2025-07-11)

Full Changelog: v0.29.0...v0.30.0

Features

• api: api update (55abbbc)
• api: api update (cbd7df0)

Bug Fixes

• ci: correct conditional (a470509)
• ci: release-doctor — report correct token name (b036bba)
• parsing: correctly handle nested discriminated unions (f57dd03)
• performance tier enum overloads (dc7c41b)

Chores

• Add bklieger-groq to CODEOWNERS (5b9fc30)
• ci: change upload type (7044a2b)
• ci: only run for pushes and fork pull requests (dc1b9ee)
• fix code owners (464ada9)
• internal: bump pinned h11 dep (47bddbd)
• internal: codegen related update (9d7f071)
• package: mark python 3.13 as supported (55353b9)
• readme: fix version rendering on pypi (e145b51)

0.29.0 (2025-06-25)

Full Changelog: v0.28.0...v0.29.0

Features

• api: api update (2f78465)
• client: add support for aiohttp (a306987)

Bug Fixes

• client: correctly parse binary response | stream (da571bc)
• tests: fix: tests which call HTTP endpoints directly with the example parameters (778531f)

Chores

• ci: enable for pull requests (daf0500)
• internal: update conftest.py (ed4b0b5)
• readme: update badges (d08d4f4)
• tests: add tests for httpx client instantiation & proxies (94821d3)
• tests: run tests in parallel (ce56989)
• tests: skip some failing tests on the latest python versions (15a744b)

Documentation

• client: fix httpx.Timeout documentation reference (5776227)

0.28.0 (2025-06-12)

Full Changelog: v0.27.0...v0.28.0

Features

• api: api update (1b088b1)
• api: api update (2a96d4f)
• api: api update (089ab40)

Chores

• fix streaming overloads (bb31101)

0.27.0 (2025-06-10)

Full Changelog: v0.26.0...v0.27.0

Features

• api: api update (3f311d6)
• client: add follow_redirects request option (407d5f6)

Chores

• docs: remove reference to rye shell (69a126e)
• docs: remove unnecessary param examples (f645e86)

0.26.0 (2025-05-29)

Full Changelog: v0.25.0...v0.26.0

Features

• api: api update (52000cb)
• api: api update (6718a54)

Chores

• docs: grammar improvements (b5f3b46)

0.25.0 (2025-05-16)

Full Changelog: v0.24.0...v0.25.0

Features

• api: api update (385969a)
• api: api update (e3acb61)
• api: api update (4bb39e5)
• api: api update (ce3c251)

Bug Fixes

• add search settings to all chat completion overloads (32a1731)
• GitHub Terraform: Create/Update .github/workflows/stale.yaml [skip ci] (a365e26)
• package: support direct resource imports (3ee8779)

Chores

• ci: fix installation instructions (454ff60)
• ci: upload sdks to package manager (1f464f8)
• fix README example (7a0f06a)
• internal: avoid errors for isinstance checks on proxies (7a04964)
• use lazy imports for resources (8c6351a)

Documentation

• remove or fix invalid readme examples (4dc027a)

0.24.0 (2025-05-02)

Full Changelog: v0.23.1...v0.24.0

Features

• api: api update (e65ff4d)

Bug Fixes

• add include/exclude_domains to all chat completions overloads (7616f4b)

0.23.1 (2025-04-24)

Full Changelog: v0.23.0...v0.23.1

Bug Fixes

• add executed_tools to streaming choicedelta (fb26fbc)
• pydantic v1: more robust ModelField.annotation check (40aaee2)

Chores

• broadly detect json family of content-type headers (2411533)
• ci: add timeout thresholds for CI jobs (aae4614)
• ci: only use depot for staging repos (b6d1b47)
• internal: codegen related update (1da64f5)
• internal: fix list file params (a9b18de)
• internal: import reformatting (5068736)
• internal: minor formatting changes (bc26d60)
• internal: refactor retries to not use recursion (488b9fe)

0.23.0 (2025-04-22)

Full Changelog: v0.22.0...v0.23.0

Features

• api: api update (f5cbd01)
• api: api update (e7c5514)
• api: api update (9d5b7c8)
• api: api update (73357e1)
• api: api update (b1d6697)
• api: api update (98ef30e)

Bug Fixes

• perf: optimize some hot paths (b1bd305)
• perf: skip traversing types for NotGiven values (ea1b705)

Chores

• client: minor internal fixes (68c2947)
• internal: base client updates (d83d3a7)
• internal: bump pyright version (49dc519)
• internal: expand CI branch coverage (ed6a533)
• internal: reduce CI branch coverage (0139f63)
• internal: remove trailing character (#233) (2781f14)
• internal: slight transform perf improvement (#235) (c67eeaa)
• internal: update models test (0ce3c37)
• internal: update pyright settings (66d55ee)
• slight wording improvement in README (#237) (fa001a3)
• tests: improve enum examples (#236) (6218620)

0.22.0 (2025-04-02)

Full Changelog: v0.21.0...v0.22.0

Features

• api: add batch cancellation (a5c3827)

0.21.0 (2025-04-01)

Full Changelog: v0.20.0...v0.21.0

Features

• api: api update (#224) (94f29cf)
• api: api update (#225) (cdf668c)
• api: manual updates (#226) (499e454)

Chores

• fix typos (#222) (51bb8ad)

0.20.0 (2025-03-19)

Full Changelog: v0.19.0...v0.20.0

Features

• api: Add speech endpoint (#219) (f150801)
• api: api update (#218) (c124862)
• api: api update (#220) (f4eeb8d)

Bug Fixes

• ci: ensure pip is always available (#216) (085166c)
• ci: remove publishing patch (#217) (fb579e8)
• types: handle more discriminated union shapes (#215) (5c72e94)

Chores

• internal: bump rye to 0.44.0 (#214) (66feae2)
• internal: codegen related update (#213) (7a16274)
• internal: remove extra empty newlines (#211) (4187fa1)

0.19.0 (2025-03-11)

Full Changelog: v0.18.0...v0.19.0

Features

• api: manual updates (#209) (15e2dca)
• client: allow passing NotGiven for body (#200) (afa6c0f)
• client: send X-Stainless-Read-Timeout header (#193) (e8911a4)

Bug Fixes

• add reasoning field to ChoiceDelta class (edfee3b)
• asyncify on non-asyncio runtimes (#198) (49387fe)
• client: mark some request bodies as optional (afa6c0f)
• GitHub Terraform: Create/Update .github/workflows/stale.yaml [skip ci] (662763a)
• GitHub Terraform: Create/Update .github/workflows/stale.yaml [skip ci] (5298ec1)

Chores

• api: remove chat_completion_chunk to force a rebuild of it (#208) (01fb0d1)
• docs: update client docstring (#204) (a0f4599)
• internal: codegen related update (#199) (de2ac71)
• internal: fix devcontainers setup (#201) (af101ee)
• internal: fix type traversing dictionary params (#195) (bcb0256)
• internal: minor type handling changes (#196) (3ff53df)
• internal: properly set pydantic_private (#202) (07ec0c8)
• internal: remove unused http client options forwarding (#205) (12fdb59)
• internal: update client tests (#197) (2f0d2c4)

Documentation

• revise readme docs about nested params (#206) (7b04f47)
• update URLs from stainlessapi.com to stainless.com (#203) (a6c6fde)

0.18.0 (2025-02-05)

Full Changelog: v0.17.0...v0.18.0

Features

• api: Add batch API (#191) (367a744)

Chores

• internal: bummp ruff dependency (#190) (61678fc)
• internal: change default timeout to an int (#188) (348e152)

0.17.0 (2025-02-03)

Full Changelog: v0.16.0...v0.17.0

Features

• api: api update (#185) (e237339)

0.16.0 (2025-01-29)

Full Changelog: v0.15.0...v0.16.0

Features

• api: api update (#183) (a5cdbc5)

Chores

• internal: codegen related update (#177) (01e6304)
• internal: codegen related update (#180) (5c8db1a)
• internal: minor formatting changes (#182) (2c4e409)
• internal: minor style changes (#181) (77c752a)

Documentation

• raw responses: fix duplicate the (#179) (a28cbd8)

0.15.0 (2025-01-11)

Full Changelog: v0.14.0...v0.15.0

Features

• api: api update (#175) (61cffbc)

Bug Fixes

• correctly handle deserialising cls fields (#174) (0b2e997)

Chores

• internal: codegen related update (#172) (d6ecada)

0.14.0 (2025-01-09)

Full Changelog: v0.13.1...v0.14.0

Features

• api: api update (#163) (43a7a5b)
• api: api update (#167) (5016206)
• api: api update (#170) (2b35e95)

Bug Fixes

• client: only call .close() when needed (#169) (6a0ec57)

Chores

• add missing isclass check (#166) (9cb1e72)
• internal: bump httpx dependency (#168) (c260ae9)
• internal: codegen related update (#158) (85b5765)
• internal: codegen related update (#160) (8b87c4d)
• internal: codegen related update (#164) (d7b6be5)
• internal: fix some typos (#162) (32482ae)

Documentation

• readme: example snippet for client context manager (#161) (b7bfd15)

0.13.1 (2024-12-14)

Full Changelog: v0.13.0...v0.13.1

Chores

• internal: add support for TypeAliasType (#153) (c5ca4fc)
• internal: bump pydantic dependency (#150) (63e5754)
• internal: bump pyright (#145) (8f2b3a0)
• internal: bump pyright (#152) (75476cd)
• internal: codegen related update (#154) (db44bd6)
• internal: codegen related update (#155) (7f303c3)
• internal: updated imports (#156) (3f41c12)
• make the Omit type public (#147) (0613ae1)

Documentation

• readme: fix http client proxies example (#151) (b858c4f)

0.13.0 (2024-11-28)

Full Changelog: v0.12.0...v0.13.0

Features

• api: api update (#134) (fde3a90)

Bug Fixes

• client: compat with new httpx 0.28.0 release (#142) (b8abf89)

Chores

• internal: exclude mypy from running on tests (#141) (fb4456e)
• internal: fix compat model_dump method when warnings are passed (#138) (91402fd)
• rebuild project due to codegen change (#136) (b79c1f9)
• rebuild project due to codegen change (#137) (2899a88)
• remove now unused cached-property dep (#140) (d001e95)

Documentation

• add info log level to readme (#139) (804a891)

0.12.0 (2024-11-12)

Full Changelog: v0.11.0...v0.12.0

Features

• api: api update (#127) (2f20c22)
• api: api update (#129) (41c4f28)

Bug Fixes

• GitHub Terraform: Create/Update .github/workflows/stale.yaml [skip ci] (537cc49)

Chores

• rebuild project due to codegen change (#130) (e08a00f)
• rebuild project due to codegen change (#131) (8a3c31d)
• rebuild project due to codegen change (#132) (8287ed4)

0.11.0 (2024-09-03)

Full Changelog: v0.10.0...v0.11.0

Features

• internal: handle streaming error (#119) (3722579)

0.10.0 (2024-08-27)

Full Changelog: v0.9.0...v0.10.0

Features

• api: OpenAPI spec update via Stainless API (#102) (42a8621)
• api: OpenAPI spec update via Stainless API (#111) (d860183)
• api: OpenAPI spec update via Stainless API (#115) (007affd)
• api: OpenAPI spec update via Stainless API (#98) (c3c42ec)
• api: update via SDK Studio (#94) (2808c19)
• api: update via SDK Studio (#97) (97f8a0a)

Chores

• ci: limit release doctor target branches (#105) (629f2d0)
• docs: document how to do per-request http client customization (#104) (9334f8b)
• internal: codegen related update (#103) (7f92641)
• internal: codegen related update (#112) (4a94475)
• internal: codegen related update (#117) (e4bc523)
• internal: use different 32bit detection method (#113) (b7f33d6)
• tests: update prism version (#106) (360ba04)

0.9.0 (2024-06-11)

Full Changelog: v0.8.0...v0.9.0

Features

• api: Fix audio transcription response formats (88e3d61)
• api: Tool calling features (c081730)

0.8.0 (2024-05-22)

Full Changelog: v0.7.0...v0.8.0

Features

• api: Define OpenAI-compatible models (bc1bb7b)

Chores

• fix array indices in README examples (5056621)
• patch streaming (9dcba61)

0.5.0 (2024-04-11)

Full Changelog: v0.4.2...v0.5.0

Features

• Add transcription and translation endpoints (d6be6e7)

Chores

• add CODEOWNERS (a1594a7)
• examples: lint (fdcb94e)
• Fix streaming before release (7dec9b7)

0.4.2 (2024-03-01)

Full Changelog: v0.4.1...v0.4.2

Features

• OpenAPI spec update via Stainless API (#19) (84ad1a4)

0.4.1 (2024-02-21)

Full Changelog: v0.1.0...v0.4.1

Features

• Add initial Stainless SDK (4de80db)
• Add initial Stainless SDK (d5a8512)
• Add initial Stainless SDK (316de2c)
• create default branch (7e00266)
• update via SDK Studio (#10) (0c0d204)
• update via SDK Studio (#14) (153744e)
• update via SDK Studio (#3) (8d92c08)

Chores

• go live (#2) (ba81c42)
• go live (#5) (75ea081)
• go live (#5) (af9a838)
• update branch (#12) (28f34e1)
• update branch (#8) (b9b55b4)

0.1.0 (2024-02-10)

Full Changelog: v0.0.1...v0.1.0

Features

• Add initial Stainless SDK (1c7e467)
• create default branch (1320cdb)
• OpenAPI spec update (#1) (87e86b0)
• OpenAPI spec update (#3) (90308e1)
• OpenAPI spec update (#4) (e983af3)
• OpenAPI spec update (#5) (cfdd6ac)