Python SDK

2.40.0 (2026-06-01)

Full Changelog: v2.39.0...v2.40.0

Features

• api: Add Amazon Bedrock Responses support

Bug Fixes

• api: allow setting bedrock api keys on the client directly (4d5bfde)

2.39.0 (2026-06-01)

Full Changelog: v2.38.0...v2.39.0

Features

• api: workload identity in audit logs, additional_tools item in responses, fix ActionSearch.query to be optional. (ab60d7a)

2.38.0 (2026-05-21)

Full Changelog: v2.37.0...v2.38.0

Features

• api: api update (33d1d01)
• api: manual updates (a21700a)
• api: update OpenAPI spec or Stainless config (00265c5)

Chores

• api: docs updates (ee10152)
• check release PR custom code sync (2638779)
• remove release automation trigger (bd6eea5)
• trigger release automation (f62d082)

2.37.0 (2026-05-13)

Full Changelog: v2.36.0...v2.37.0

Features

• api: add service_tier parameter to responses compact method (625827c)
• internal/types: support eagerly validating pydantic iterators (7e527bc)
• Remove unnecessary client_id when using workload identity provider for auth (c39ea8d)

Bug Fixes

• client: add missing f-string prefix in file type error message (c85ebd9)

2.36.0 (2026-05-07)

Full Changelog: v2.35.1...v2.36.0

Features

• api: manual updates (13c639c)
• api: realtime 2 (8fe0ab8)

2.35.1 (2026-05-06)

Full Changelog: v2.35.0...v2.35.1

Bug Fixes

• api: fix imagegen size enum regression (4484653)

2.35.0 (2026-05-06)

Full Changelog: v2.34.0...v2.35.0

Features

• api: update image 2 (0ba55d7)
• api: manual updates (72bf67a)

Chores

• remove legacy python cli (32f36e4)
• rename legacy python cli entrypoint (a3b182d)

Documentation

• api: update top_logprobs parameter description across chat and responses (f9d339f)

2.34.0 (2026-05-04)

Full Changelog: v2.33.0...v2.34.0

Features

• api: add external_key_id to projects, email/metadata params to users, update types (2d232ee)
• api: add support for Admin API Keys per endpoint (b8b176a)
• api: admin API updates (4ae1138)
• api: manual updates (c1870f1)
• api: manual updates (f6bb9c7)
• support setting headers via env (1e89d8b)

Bug Fixes

• allow explicit Azure auth headers (a0626ba)
• api: correct prompt_cache_retention enum value from in-memory to in_memory (d47d9f0)
• api: preserve python api key attribute type (62607f6)
• api: resolve python auth type checks (42a31a7)
• api: support admin api key auth (f029eb9)
• avoid bearer fallback for admin auth (22e01a8)
• preserve selected auth credentials (0d27f9d)
• require bearer auth for stream helpers (d055539)
• types: correct created_at and completed_at to float in Response (7da4b88)
• types: correct timestamp types to int in Response model (e55631c)
• use correct field name format for multipart file arrays (9ee4825)

Performance Improvements

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

Chores

• internal: more robust bootstrap script (9ec1600)
• internal: reformat pyproject.toml (12ad57b)
• tests: bump steady to v0.22.1 (486dfed)

Documentation

• api: add rate limit and vector store info to files create (4f776df)
• api: update files rate limit documentation (b141a20)

2.33.0 (2026-04-28)

Full Changelog: v2.32.0...v2.33.0

Features

• api: api update (18f834a)

Bug Fixes

• api: correct prompt_cache_retention enum value from in-memory to in_memory (#1822) (f9d2d13)

Chores

• ci: remove release-doctor workflow (00b2091)

2.32.0 (2026-04-15)

Full Changelog: v2.31.0...v2.32.0

Features

• api: Add detail to InputFileContent (60de21d)
• api: add OAuthErrorCode type (0c8d2c3)
• client: add event handler implementation for websockets (0280d05)
• client: allow enqueuing to websockets even when not connected (67aa20e)
• client: support reconnection in websockets (eb72a95)

Bug Fixes

• ensure file data are only sent as 1 parameter (c0c2ecd)

Documentation

• improve examples (84712fa)

2.31.0 (2026-04-08)

Full Changelog: v2.30.0...v2.31.0

Features

• api: add phase field to conversations message (3e5834e)
• api: add web_search_call.results to ResponseIncludable type (ffd8741)
• client: add support for short-lived tokens (#1608) (22fe722)
• client: support sending raw data over websockets (f1bc52e)
• internal: implement indices array format for query and form serialization (49194cf)

Bug Fixes

• client: preserve hardcoded query params when merging with user params (92e109c)
• types: remove web_search_call.results from ResponseIncludable (d3cc401)

Chores

• tests: bump steady to v0.20.1 (d60e2ee)
• tests: bump steady to v0.20.2 (6508d47)

Documentation

• api: update file parameter descriptions in vector_stores files and file_batches (a9e7ebd)

2.30.0 (2026-03-25)

Full Changelog: v2.29.0...v2.30.0

Features

• api: add keys field to Click/DoubleClick/Drag/Move/Scroll computer actions (ee1bbed)

Bug Fixes

• api: align SDK response types with expanded item schemas (f3f258a)
• sanitize endpoint path params (89f6698)
• types: make type required in ResponseInputMessageItem (cfdb167)

Chores

• ci: skip lint on metadata-only changes (faa93e1)
• internal: update gitignore (c468477)
• tests: bump steady to v0.19.4 (f350af8)
• tests: bump steady to v0.19.5 (5c03401)
• tests: bump steady to v0.19.6 (b6353b8)
• tests: bump steady to v0.19.7 (1d654be)

Refactors

• tests: switch from prism to steady (4a82035)

2.29.0 (2026-03-17)

Full Changelog: v2.28.0...v2.29.0

Features

• api: 5.4 nano and mini model slugs (3b45666)
• api: add /v1/videos endpoint to batches create method (c0e7a16)
• api: add defer_loading field to ToolFunction (3167595)
• api: add in and nin operators to ComparisonFilter type (664f02b)

Bug Fixes

• deps: bump minimum typing-extensions version (a2fb2ca)
• pydantic: do not pass by_alias unless set (8ebe8fb)

Chores

• internal: tweak CI branches (96ccc3c)

2.28.0 (2026-03-13)

Full Changelog: v2.27.0...v2.28.0

Features

• api: custom voices (50dc060)

2.27.0 (2026-03-13)

Full Changelog: v2.26.0...v2.27.0

Features

• api: api update (60ab24a)
• api: manual updates (b244b09)
• api: manual updates (d806635)
• api: sora api improvements: character api, video extensions/edits, higher resolution exports. (58b70d3)

Bug Fixes

• api: repair merged videos resource (742d8ee)

Chores

• internal: codegen related update (4e6498e)
• internal: codegen related update (93af129)
• match http protocol with ws protocol instead of wss (026f9de)
• use proper capitalization for WebSockets (a2f9b07)

2.26.0 (2026-03-05)

Full Changelog: v2.25.0...v2.26.0

Features

• api: The GA ComputerTool now uses the CompuerTool class. The 'computer_use_preview' tool is moved to ComputerUsePreview (78f5b3c)

2.25.0 (2026-03-05)

Full Changelog: v2.24.0...v2.25.0

Features

• api: gpt-5.4, tool search tool, and new computer tool (6b2043f)
• api: remove prompt_cache_key param from responses, phase field from message types (44fb382)

Bug Fixes

• api: internal schema fixes (0c0f970)
• api: manual updates (9fc323f)
• api: readd phase (1b27b5a)

Chores

• internal: codegen related update (bdb837d)
• internal: codegen related update (b1de941)
• internal: reduce warnings (7cdbd06)

2.24.0 (2026-02-24)

Full Changelog: v2.23.0...v2.24.0

Features

• api: add phase (391deb9)

Bug Fixes

• api: fix phase enum (42ebf7c)
• api: phase docs (7ddc61c)

Chores

• internal: make test_proxy_environment_variables more resilient to env (65af8fd)
• internal: refactor sse event parsing (2344600)

2.23.0 (2026-02-24)

Full Changelog: v2.22.0...v2.23.0

Features

• api: add gpt-realtime-1.5 and gpt-audio-1.5 model options to realtime calls (3300b61)

Chores

• internal: make test_proxy_environment_variables more resilient (6b441e2)

2.22.0 (2026-02-23)

Full Changelog: v2.21.0...v2.22.0

Features

• api: websockets for responses api (c01f6fb)

Chores

• internal: add request options to SSE classes (cdb4315)
• update mock server docs (91f4da8)

Documentation

• api: add batch size limit to file_batches parameter descriptions (16ae76a)
• api: enhance method descriptions across audio, chat, realtime, skills, uploads, videos (21f9e5a)
• api: update safety_identifier documentation in chat completions and responses (d74bfff)