Changelog
3.35.0 (2026-05-07)
Full Changelog: v3.34.0...v3.35.0
Features
- api: add quantity field to admin organization usage costs results (899b6de)
- api: launch realtime translate + update image 2 (1fbf3a6)
- api: manual updates (cd9047f)
- api: realtime 2 (5b51410)
Bug Fixes
- api: fix imagegen
size enum regression (995778e)
- types: add format tags for URI and timestamp fields across models (a6c2198)
Chores
- internal: regenerate SDK with no functional changes (71c80ef)
- redact api-key headers in debug logs (ff51a02)
Documentation
- api: document web_search_call.results output data option (6c2d8ef)
3.34.0 (2026-05-01)
Full Changelog: v3.33.0...v3.34.0
Features
- api: add group_type, external_key_id, user fields to admin organization models (460f400)
- api: add support for Admin API Keys per endpoint (51a0561)
- api: admin API updates (a0ad21e)
- api: manual updates (b60b3bc)
- api: manual updates (f4e0c1a)
Bug Fixes
- auth: prefer admin keys for admin requests (d128349)
- types: add format annotations to ChatKit timestamp and URL fields (0b7d7d0)
- types: add format annotations to timestamp and URL fields across resources (0ff11a7)
- types: change timestamp fields to float64 in Response (d714e3c)
3.33.0 (2026-04-28)
Full Changelog: v3.32.0...v3.33.0
Features
- go: add default http client with timeout (25dd39a)
- support setting headers via env (b4eaa78)
Bug Fixes
- types: change PromptCacheRetention enum in-memory to in_memory (15e7432)
Chores
- internal: more robust bootstrap script (eb0cbcf)
- tests: bump steady to v0.22.1 (ef28f59)
Documentation
- api: add rate limit and vector store guidance to file upload (6c8c7fa)
- api: update rate limit documentation in file upload method (54fde2c)
3.32.0 (2026-04-16)
Full Changelog: v3.31.0...v3.32.0
Features
- api: Add detail to InputFileContent (b8e782f)
- api: add OAuthErrorCode type (d54fff1)
- api: add prompt_cache_retention parameter to response compact (e2da10d)
Bug Fixes
Documentation
3.31.0 (2026-04-08)
Full Changelog: v3.30.0...v3.31.0
Features
- api: add phase field to conversation messages (563d747)
- api: add web_search_call.results to ResponseIncludable (6ef5b20)
- client: add support for short-lived tokens (#799) (038871e)
- internal: support comma format in multipart form encoding (905b473)
Bug Fixes
- fix issue with unmarshaling in some cases (a017bc6)
- prevent duplicate ? in query params (cbb2c75)
- types: remove web_search_call.results from ResponseIncludable (180597f)
Chores
- ci: support opting out of skipping builds on metadata-only commits (12e3a5a)
- remove unnecessary error check for url parsing (cfe9c41)
- tests: bump steady to v0.20.1 (8e4ef11)
- tests: bump steady to v0.20.2 (ad31f81)
- update docs for api:"required" (2d16ebc)
Documentation
- api: add multi-file ingestion guidance to vectorstorefile/filebatch params (dbba33f)
3.30.0 (2026-03-25)
Full Changelog: v3.29.0...v3.30.0
Features
- api: add keys field to computer action types (7abb3c4)
Bug Fixes
- api: align SDK response types with expanded item schemas (324c584)
- types: generate shared enum types that are not referenced by other schemas (e2f2920)
- types: make Type required, correct enum in ResponseInputMessageItem (8c2c7a5)
Chores
- ci: skip lint on metadata-only changes (40cf884)
- client: fix multipart serialisation of Default() fields (06c04ae)
- internal: support default value struct tag (f1afb2a)
- internal: update gitignore (bde0a0d)
- tests: bump steady to v0.19.4 (a0561c3)
- tests: bump steady to v0.19.5 (56c5c36)
- tests: bump steady to v0.19.6 (44ebe37)
- tests: bump steady to v0.19.7 (1b04072)
Refactors
- tests: switch from prism to steady (2185358)
3.29.0 (2026-03-17)
Full Changelog: v3.28.0...v3.29.0
Features
- api: 5.4 nano and mini model slugs (c4ebb48)
- api: add in and nin values to comparison filter type (d060d44)
Chores
- internal: tweak CI branches (6379626)
3.28.0 (2026-03-14)
Full Changelog: v3.27.0...v3.28.0
Features
- api: add /v1/videos endpoint option to batch (7b2d67e)
- api: add defer_loading field to function tools (6d4b683)
- api: custom voices (d00b782)
⚠ BREAKING CHANGES
- api: The
voice param and resouce has changed from a string to a string | {id: string}. This is a breaking change for Go.
3.27.0 (2026-03-13)
Full Changelog: v3.26.0...v3.27.0
Features
- api: add video character/edit/extend, remove Azure/webhook/polling/accumulator (20da043)
- api: add video edits/extensions/character, remove Azure/webhook/polling helpers (fa9413f)
- api: api update (c88c6c9)
- api: sora api improvements: character api, video extensions/edits, higher resolution exports. (93f6779)
Chores
- internal: codegen related update (d531232)
- internal: codegen related update (1748c11)
- internal: codegen related update (531ece1)
- internal: codegen related update (ce9f435)
3.26.0 (2026-03-05)
Full Changelog: v3.25.0...v3.26.0
Features
- api: The GA ComputerTool now uses the CompuerTool class. The 'computer_use_preview' tool is moved to ComputerUsePreview (347418b)
3.25.0 (2026-03-05)
Full Changelog: v3.24.0...v3.25.0
Features
- api: gpt-5.4, tool search tool, and new computer tool (101826d)
- api: remove Phase from input/output messages, PromptCacheKey from responses (961b8ca)
Bug Fixes
Chores
- internal: codegen related update (ab733b9)
- internal: codegen related update (23d1831)
- internal: reduce warnings (2963312)
3.24.0 (2026-02-24)
Full Changelog: v3.23.0...v3.24.0
Features
Bug Fixes
Chores
- internal: move custom custom
json tags to api (0735303)
- internal: refactor sse event parsing (45dc6bb)
3.24.0 (2026-02-24)
Full Changelog: v3.23.0...v3.24.0
Features
Bug Fixes
Chores
- internal: move custom custom
json tags to api (0735303)
- internal: refactor sse event parsing (45dc6bb)
3.23.0 (2026-02-24)
Full Changelog: v3.22.1...v3.23.0
Features
- api: add gpt-realtime-1.5 and gpt-audio-1.5 models to realtime session (9076e2f)
3.22.1 (2026-02-23)
Full Changelog: v3.22.0...v3.22.1
Bug Fixes
- allow canceling a request while it is waiting to retry (54672cf)
Chores
Documentation
- api: add batch size limit to vector store file batch parameters (f751c40)
- api: clarify safety_identifier max length in chat completions and responses (8257f9b)
- api: enhance method docstrings across audio/chat/completion/skill/upload/video APIs (38b8f63)
3.22.0 (2026-02-13)
Full Changelog: v3.21.0...v3.22.0
Features
- api: container network_policy and skills (8e5ea23)
Bug Fixes
- encoder: correctly serialize NullStruct (a6cb49e)
Documentation
3.21.0 (2026-02-10)
Full Changelog: v3.20.0...v3.21.0
Features
- api: support for images in batch api (e23aeb1)
3.20.0 (2026-02-10)
Full Changelog: v3.19.0...v3.20.0
Features
- api: skills and hosted shell (9e191de)
3.19.0 (2026-02-09)
Full Changelog: v3.18.0...v3.19.0
Features
- api: responses context_management (199f230)
3.18.0 (2026-02-05)
Full Changelog: v3.17.0...v3.18.0
Features
- api: add shell_call_output status field (67a75d7)
- api: image generation actions for responses; ResponseFunctionCallArgumentsDoneEvent.name (2c57016)
Bug Fixes
- client: undo change to web search Find action (e340256)
- client: update type for
find_in_page action (4b5d499)
Chores
- client: improve example values (c86a65c)
Documentation
- split
api.md by standalone resources (aeed37b)
3.17.0 (2026-01-27)
Full Changelog: v3.16.0...v3.17.0
Features
- api: api update (a456c60)
- api: api updates (21fd4a9)
- client: add a convenient param.SetJSON helper (1b35ece)
- client: add a StreamError type to access raw events from sse streams (fd14b30)
Bug Fixes
- api: mark assistants as deprecated (9a8c9af)
- client: retain streaming when user sets request body (3a7a22e)
- docs: add missing pointer prefix to api.md return types (dd641d9)
Chores
- internal: codegen related update (74d3989)
- internal: update
actions/checkout version (2db54a5)
3.16.0 (2026-01-09)
Full Changelog: v3.15.0...v3.16.0
Features
- api: add new Response completed_at prop (bff6331)
Bug Fixes
- client: use the correct order of params for vector store file and batch polling (ef32641)
Chores
- internal: codegen related update (1e529a4)
- internal: use different example values for some enums (a2836ee)
Documentation
3.15.0 (2025-12-19)
Full Changelog: v3.14.0...v3.15.0
Bug Fixes
Chores
- add float64 to valid types for RegisterFieldValidator (e67d89d)
3.14.0 (2025-12-16)
Full Changelog: v3.13.0...v3.14.0
Features
3.13.0 (2025-12-15)
Full Changelog: v3.12.0...v3.13.0
Features
- api: api update (20b5112)
- api: fix grader input list, add dated slugs for sora-2 (e8f0b76)
Bug Fixes
- azure: correct Azure OpenAI API URL construction and auth (3ba3736)
3.12.0 (2025-12-11)
Full Changelog: v3.11.0...v3.12.0
Features
- api: gpt 5.2 (56b5d41)
- encoder: support bracket encoding form-data object members (a2cbacf)
3.11.0 (2025-12-10)
Full Changelog: v3.10.0...v3.11.0
Features
- api: make model required for the responses/compact endpoint (05f8f4d)
Bug Fixes
- mcp: correct code tool API endpoint (03d08f9)
- rename param to avoid collision (17d276d)
Chores
- elide duplicate aliases (2bf988e)
- internal: codegen related update (9b1a3e9)
3.10.0 (2025-12-04)
Full Changelog: v3.9.0...v3.10.0
Features
- api: gpt-5.1-codex-max and responses/compact (1e1ca2a)
3.9.0 (2025-12-01)
Full Changelog: v3.8.1...v3.9.0
Features
Bug Fixes
- api: align types of input items / output items for typescript (5b89d3b)
- client: correctly specify Accept header with / instead of empty (fbadb4e)
Chores
3.8.1 (2025-11-04)
Full Changelog: v3.8.0...v3.8.1
Bug Fixes
- api: fix nullability of logprobs (b5aeb99)
3.8.0 (2025-11-03)
Full Changelog: v3.7.0...v3.8.0
Features
- api: Realtime API token_limits, Hybrid searching ranking options (9495f4a)
Chores
- internal: grammar fix (it's -> its) (879772d)
3.7.0 (2025-10-28)
Full Changelog: v3.6.1...v3.7.0
Features
- api: remove InputAudio from ResponseInputContent (cf50c53)
- azure: allow passing custom scopes (#541) (dffa08e)
Bug Fixes
3.6.1 (2025-10-20)
Full Changelog: v3.6.0...v3.6.1
Bug Fixes
- api: fix discriminator propertyName for ResponseFormatJsonSchema (57b0505)
3.6.0 (2025-10-20)
Full Changelog: v3.5.0...v3.6.0
Features
- api: Add responses.input_tokens.count (a43f2ce)
Bug Fixes
- api: internal openapi updates (7ad9b02)
3.5.0 (2025-10-17)
Full Changelog: v3.4.0...v3.5.0
Features
3.4.0 (2025-10-16)
Full Changelog: v3.3.0...v3.4.0
Features
- api: Add support for gpt-4o-transcribe-diarize on audio/transcriptions endpoint (ee32400)
Chores
- api: internal updates (74c8031)
- client: undo more naming changes (db441bc)
- client: undo some naming changes (a5aa3d6)
3.3.0 (2025-10-10)
Full Changelog: v3.2.0...v3.3.0
Features
- api: comparison filter in/not in (d6daca0)
3.2.0 (2025-10-06)
Full Changelog: v3.1.0...v3.2.0
Features
- api: dev day 2025 launches (d40a768)
3.1.0 (2025-10-02)
Full Changelog: v3.0.1...v3.1.0
Features
- api: add support for realtime calls (565ca67)
3.0.1 (2025-10-01)
Full Changelog: v3.0.0...v3.0.1
Bug Fixes
- api: add status, approval_request_id to MCP tool call (a7f95e4)
3.0.0 (2025-09-30)
Full Changelog: v2.7.1...v3.0.0
⚠ BREAKING CHANGES
- api:
ResponseFunctionToolCallOutputItem.output and ResponseCustomToolCallOutput.output now return string | Array<ResponseInputText | ResponseInputImage | ResponseInputFile> instead of string only. This may break existing callsites that assume output is always a string.
Features
- api: Support images and files for function call outputs in responses, BatchUsage (21901ef)
2.7.1 (2025-09-29)
Full Changelog: v2.7.0...v2.7.1
Bug Fixes
- bugfix for setting JSON keys with special characters (f9ae028)
2.7.0 (2025-09-23)
Full Changelog: v2.6.1...v2.7.0
Features
2.6.1 (2025-09-22)
Full Changelog: v2.6.0...v2.6.1
Bug Fixes
- api: fix mcp tool name (6de601a)
- use slices.Concat instead of sometimes modifying r.Options (7312ee7)
Chores
- api: openapi updates for conversations (4a7d204)
- bump minimum go version to 1.22 (8396ab5)
- do not install brew dependencies in ./scripts/bootstrap by default (d519b81)
- update more docs for 1.22 (1b0514d)
2.6.0 (2025-09-19)
Full Changelog: v2.5.0...v2.6.0
Features
2.5.0 (2025-09-17)
Full Changelog: v2.4.3...v2.5.0
Features
- api: type updates for conversations, reasoning_effort and results for evals (3e68a60)
2.4.3 (2025-09-15)
Full Changelog: v2.4.2...v2.4.3
Chores
- api: docs and spec refactoring (e67af66)
2.4.2 (2025-09-12)
Full Changelog: v2.4.1...v2.4.2
Chores
- api: Minor docs and type updates for realtime (d92ea48)
2.4.1 (2025-09-10)
Full Changelog: v2.4.0...v2.4.1
Chores
- api: fix realtime GA types (012b83e)
2.4.0 (2025-09-08)
Full Changelog: v2.3.1...v2.4.0
Features
- api: ship the RealtimeGA API shape (2b6c6db)
2.3.1 (2025-09-05)
Full Changelog: v2.3.0...v2.3.1
Bug Fixes
- internal: unmarshal correctly when there are multiple discriminators (98596b2)
2.3.0 (2025-09-03)
Full Changelog: v2.2.2...v2.3.0
Features
- api: Add gpt-realtime models (3cf6a34)
2.2.2 (2025-09-02)
Full Changelog: v2.2.1...v2.2.2
Bug Fixes
- update url to refresh pkg.go.dev (edf94ce)
- use release please annotations on more places (2ff82f9)
2.2.1 (2025-09-02)
Full Changelog: v2.2.0...v2.2.1
Chores
- api: manual updates for ResponseInputAudio (8c0ebe5)
2.2.0 (2025-09-02)
Full Changelog: v2.1.1...v2.2.0
Features
- api: Add connectors support for MCP tool (35888bc)
- api: add web search filters (6f2c71d)
- api: adding support for /v1/conversations to the API (5b7c31b)
- api: realtime API updates (130fc8e)
- client: add support for verifying signatures on incoming webhooks (f7c8dbb)
Bug Fixes
- azure: compatibility with edit image endpoint (#477) (d156eec)
- close body before retrying (8dfed35)
Chores
- internal/ci: setup breaking change detection (0af0cd0)
- internal: version bump (3265795)
2.1.1 (2025-08-20)
Full Changelog: v2.1.0...v2.1.1
Chores
- api: accurately represent shape for verbosity on Chat Completions (f81197b)
2.1.0 (2025-08-18)
Full Changelog: v2.0.2...v2.1.0
Features
- api: add new text parameters, expiration options (323154c)
Documentation
- give https its missing "h" in Azure OpenAI REST API link (#480) (8a401c9)
2.0.2 (2025-08-09)
Full Changelog: v2.0.1...v2.0.2
Chores
- internal: update comment in script (4be24de)
- update @stainless-api/prism-cli to v5.15.0 (eca22af)
2.0.1 (2025-08-08)
Full Changelog: v2.0.0...v2.0.1
Bug Fixes
- client: fix verbosity parameter location in Responses (6e2e903)
2.0.0 (2025-08-07)
Full Changelog: v1.12.0...v2.0.0
Breaking changes
With the launch of custom tools in Chat Completions, function tools have been renamed to clarify the difference between the two.
ChatCompletionToolParam has become a union and is now named ChatCompletionToolUnionParam.
Older versions of the SDK used function tools: to migrate
- openai.ChatCompletionToolParam{
- Function: openai.FunctionDefinitionParam{
+ openai.ChatCompletionFunctionTool(
+ openai.FunctionDefinitionParam{
Name: "get_weather",
Description: openai.String("Get weather at the given location"),
Parameters: openai.FunctionParameters{ … },
+ },
+ )
- },
Features
- api: adds GPT-5 and new API features: platform.openai.com/docs/guides/gpt-5 (af46c88)
- api: manual updates (219f209)
- client: remove HTML escaping in JSON (aea5ebc)
- client: rename union helpers (645e881)
- client: support optional json html escaping (1d2336b)
Bug Fixes
- client: revert path param changes (9239f06)
Chores
- change readme warning and minimum version (1d0e22f)
- document breaking changes (afaa2b8)
- migrate examples (9c57dd7)
1.12.0 (2025-07-30)
Full Changelog: v1.11.1...v1.12.0
Features
