Python SDK

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)

2.21.0 (2026-02-13)

Full Changelog: v2.20.0...v2.21.0

Features

• api: container network_policy and skills (d19de2e)

Bug Fixes

• structured outputs: resolve memory leak in parse methods (#2860) (6dcbe21)
• webhooks: preserve method visibility for compatibility checks (44a8936)

Chores

• internal: fix lint error on Python 3.14 (534f215)

Documentation

• split api.md by standalone resources (96e41b3)
• update comment (63def23)

2.20.0 (2026-02-10)

Full Changelog: v2.19.0...v2.20.0

Features

• api: support for images in batch api (28edb6e)

2.19.0 (2026-02-10)

Full Changelog: v2.18.0...v2.19.0

Features

• api: skills and hosted shell (27fdf68)

Chores

• internal: bump dependencies (fae10fd)

2.18.0 (2026-02-09)

Full Changelog: v2.17.0...v2.18.0

Features

• api: add context_management to responses (137e992)
• api: responses context_management (c3bd017)

2.17.0 (2026-02-05)

Full Changelog: v2.16.0...v2.17.0

Features

• api: add shell_call_output status field (1bbaf88)
• api: image generation actions for responses; ResponseFunctionCallArgumentsDoneEvent.name (7d96513)
• client: add custom JSON encoder for extended type support (9f43c8b)

Bug Fixes

• client: undo change to web search Find action (8f14eb0)
• client: update type for find_in_page action (ec54dde)

2.16.0 (2026-01-27)

Full Changelog: v2.15.0...v2.16.0

Features

• api: api update (b97f9f2)
• api: api updates (9debcc0)
• client: add support for binary request streaming (49561d8)

Bug Fixes

• api: mark assistants as deprecated (0419cbc)

Chores

• ci: upgrade actions/github-script (5139f13)
• internal: update actions/checkout version (f276714)

Documentation

• examples: update Azure Realtime sample to use v1 API (#2829) (3b31981)

2.15.0 (2026-01-09)

Full Changelog: v2.14.0...v2.15.0

Features

• api: add new Response completed_at prop (f077752)

Chores

• internal: codegen related update (e7daba6)

2.14.0 (2025-12-19)

Full Changelog: v2.13.0...v2.14.0

Features

• api: slugs for new audio models; make all model params accept strings (e517792)

Bug Fixes

• use async_to_httpx_files in patch method (a6af9ee)

Chores

• internal: add --fix argument to lint script (93107ef)

2.13.0 (2025-12-16)

Full Changelog: v2.12.0...v2.13.0

Features

• api: gpt-image-1.5 (1c88f03)

Chores

• ci: add CI job to detect breaking changes with the Agents SDK (#1436) (237c91e)
• internal: add missing files argument to base client (e6d6fd5)