release: 3.20.0

[openai-sdks]

Automated Release PR

3.20.0 (2026-09-28)

Features

• api: add Agents credential and session options (#3967) (bb68198)
• api: add Cyber access programs to Responses (#3956) (09c5b6f)
• responses: opt in to incremental WebSocket text and tool snapshots (#3973) (d0207b4)
• responses: preserve detailed WebSocket accumulator snapshots (#3981) (a380cf2)

Bug Fixes

• client: retry unmapped TLS transport errors (#3982) (0d35a26)
• live: avoid hangs at fractional transcript grouping deadlines (#3970) (4ef4129)
• live: keep query parameters out of WebSocket endpoint paths (#3972) (f9c458b)
• live: preserve caller queues and prevent uncertain WebSocket replay (#3980) (80e9686)
• realtime: preserve base URL queries in WebSocket upgrades (#3971) (f7bd4a7)
• realtime: retain configured queues without replaying attempted sends (#3978) (a52805c)

Chores

• api: clarify documented API error responses (#3965) (384fee3)
• api: document batch error responses (#3961) (6e4a79c)
• api: document files and uploads error responses (#3960) (a9d727f)
• api: document fine-tuning and model errors (#3964) (5d4003c)
• api: document Responses not-found errors (#3959) (63099e7)
• api: document stored chat completion errors (#3963) (a73fe0c)

---

This PR was generated with Release Please. See documentation.

[openai-sdks]

OkTest Summary

✅ 236/236 SDK tests passed in 10.82s for Python SDK PR #3957.

Test results — 42 files

Test	Result	Time
tests/chat-completions-complex-body.test.ts	✅ Passed	173ms
tests/chat-completions-create.test.ts	✅ Passed	194ms
tests/chat-completions-stream.test.ts	✅ Passed	233ms
tests/files-content-binary.test.ts	✅ Passed	199ms
tests/files-create-multipart.test.ts	✅ Passed	185ms
tests/files-list-pagination.test.ts	✅ Passed	137ms
tests/initialize-config.test.ts	✅ Passed	161ms
tests/instance-isolation.test.ts	✅ Passed	149ms
tests/models-list.test.ts	✅ Passed	180ms
tests/responses-background-lifecycle.test.ts	✅ Passed	206ms
tests/responses-body-method-errors.test.ts	✅ Passed	377ms
tests/responses-cancel-timeout.test.ts	✅ Passed	196ms
tests/responses-cancel.test.ts	✅ Passed	223ms
tests/responses-compact-retries.test.ts	✅ Passed	268ms
tests/responses-compact.test.ts	✅ Passed	279ms
tests/responses-create-advanced-stream.test.ts	✅ Passed	138ms
tests/responses-create-advanced.test.ts	✅ Passed	221ms
tests/responses-create-disconnect.test.ts	✅ Passed	1.217s
tests/responses-create-errors.test.ts	✅ Passed	242ms
tests/responses-create-malformed-api-responses.test.ts	✅ Passed	189ms
tests/responses-create-retries.test.ts	✅ Passed	234ms
tests/responses-create-stream-failures.test.ts	✅ Passed	823ms
tests/responses-create-stream-timeout.test.ts	✅ Passed	258ms
tests/responses-create-stream-wire.test.ts	✅ Passed	3.218s
tests/responses-create-stream.test.ts	✅ Passed	185ms
tests/responses-create-terminal-states.test.ts	✅ Passed	221ms
tests/responses-create-timeout.test.ts	✅ Passed	223ms
tests/responses-create.test.ts	✅ Passed	527ms
tests/responses-delete.test.ts	✅ Passed	167ms
tests/responses-input-items-errors.test.ts	✅ Passed	619ms
tests/responses-input-items-list.test.ts	✅ Passed	320ms
tests/responses-input-items-options.test.ts	✅ Passed	273ms
tests/responses-input-tokens-count-timeout.test.ts	✅ Passed	236ms
tests/responses-input-tokens-count.test.ts	✅ Passed	158ms
tests/responses-malformed-inputs.test.ts	✅ Passed	2.162s
tests/responses-not-found-errors.test.ts	✅ Passed	281ms
tests/responses-parse.test.ts	✅ Passed	243ms
tests/responses-retrieve-retries.test.ts	✅ Passed	236ms
tests/responses-retrieve.test.ts	✅ Passed	189ms
tests/responses-stored-method-errors.test.ts	✅ Passed	588ms
tests/retry-behavior.test.ts	✅ Passed	3.085s
tests/sdk-error-shape.test.ts	✅ Passed	320ms

View OkTest run #36447125778

_{SDK merge (a7f2d0ced522) · head (4d9030007f36) · base (0d35a2640458) · OkTest (8728ddef7fc7)}

[github-actions]

Castiron custom code

✅ No new custom-code files detected.

48 mixed files remain; 0 existing customizations changed.

Compared 0d35a2640458 → 4d9030007f36. Generated baselines verified.

48 existing customizations unchanged

• api.md
• scripts/castiron/README.md
• scripts/castiron/custom_code_report.py
• scripts/castiron/test_custom_code_report.py
• src/openai/init.py
• src/openai/_client.py
• src/openai/resources/audio/transcriptions.py
• src/openai/resources/audio/translations.py
• src/openai/resources/beta/agents/sessions/sessions.py
• src/openai/resources/beta/beta.py
• src/openai/resources/beta/responses/responses.py
• src/openai/resources/beta/threads/runs/runs.py
• src/openai/resources/beta/threads/threads.py
• src/openai/resources/chat/completions/completions.py
• src/openai/resources/embeddings.py
• src/openai/resources/files.py
• src/openai/resources/live/forks.py
• src/openai/resources/live/live.py
• src/openai/resources/live/sideband.py
• src/openai/resources/realtime/api.md
• src/openai/resources/realtime/realtime.py
• src/openai/resources/responses/responses.py
• src/openai/resources/uploads/uploads.py
• src/openai/resources/vector_stores/file_batches.py
• src/openai/resources/vector_stores/files.py
• src/openai/resources/videos.py
• src/openai/resources/webhooks/init.py
• src/openai/resources/webhooks/webhooks.py
• src/openai/types/beta/agent_session_message.py
• src/openai/types/chat/init.py
• src/openai/types/chat/chat_completion_message_tool_call.py
• src/openai/types/fine_tuning/fine_tuning_job_integration.py
• src/openai/types/realtime/conversation_item_input_audio_transcription_delta_event.py
• src/openai/types/realtime/realtime_error_event.py
• src/openai/types/responses/init.py
• src/openai/types/responses/response.py
• src/openai/types/responses/response_function_web_search.py
• src/openai/types/responses/response_function_web_search_param.py
• src/openai/types/responses/responses_client_event.py
• src/openai/types/responses/responses_client_event_param.py

8 more in the full report.

A changed generated baseline means this report cannot reliably identify which handwritten lines changed.

Inspect the custom-code diff

Download the exact patch produced by this run (requires repository access):

gh run download 36447168829 --repo openai/openai-python \
  --name castiron-custom-code-36447168829-1 --dir /tmp/castiron-custom-code-36447168829-1
git apply --stat /tmp/castiron-custom-code-36447168829-1/custom-code.patch
cat /tmp/castiron-custom-code-36447168829-1/custom-code.patch

Or reproduce it from an SDK checkout containing the vendored reporter:

git fetch --no-tags origin 0d35a2640458b64ed2ff4a7c9b1f1a1e5705336e 4d9030007f36edff98b693d0d143845ef93f55a6
python3 scripts/castiron/custom_code_report.py report \
  --base 0d35a2640458b64ed2ff4a7c9b1f1a1e5705336e \
  --head 4d9030007f36edff98b693d0d143845ef93f55a6 --fetch --require-head-hash --public \
  --out /tmp/castiron-custom-code-4d9030007f36
cat /tmp/castiron-custom-code-4d9030007f36/custom-code.patch

This is the current full custom patch for mixed files, not an attribution of only the handwritten lines changed by this PR.

Full report and patch

[openai-sdks]

🤖 Created releases:

• v3.20.0

🌻