release: 3.36.0

[openai-sdks]

Automated Release PR

3.36.0 (2026-10-20)

Features

• api: add 30-minute cache-write usage counts (#4111) (5589146)
• api: add compaction trigger IDs (#4122) (0e5794d)
• types: prepare native synchronous WebSocket option type (#4118) (90c0bac)

Bug Fixes

• api: accept canonical batch responses in strict mode (#4106) (6eaa90e)
• preserve declared aliases during Pydantic v1 validation (#4119) (8b1cac9)
• preserve WebSocket close across recovery and cancellation (#4117) (4590ff1)
• realtime: honor native options for legacy beta sockets (#4120) (8968560)

Chores

• api: use neutral moderation examples (#4104) (553703e)
• restore generated Castiron reporting scripts (#4113) (9d12b56)

Documentation

• plan the Python generated-code transition (#4114) (6a52987)
• record Python transition progress and batch follow-up work (#4116) (46e3680)

---

This PR was generated with Release Please. See documentation.

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-10-20T04:41:18.465779Z	d474b66	New commits
🔒 Security Review	✅ Completed 2026-10-20T04:41:54.325921Z	d474b66	New commits

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[openai-sdks]

OkTest Summary

✅ 236/236 SDK tests passed in 7.293s for Python SDK PR #4105.

Test results — 42 files

Test	Result	Time
tests/chat-completions-complex-body.test.ts	✅ Passed	162ms
tests/chat-completions-create.test.ts	✅ Passed	185ms
tests/chat-completions-stream.test.ts	✅ Passed	124ms
tests/files-content-binary.test.ts	✅ Passed	146ms
tests/files-create-multipart.test.ts	✅ Passed	161ms
tests/files-list-pagination.test.ts	✅ Passed	115ms
tests/initialize-config.test.ts	✅ Passed	108ms
tests/instance-isolation.test.ts	✅ Passed	133ms
tests/models-list.test.ts	✅ Passed	197ms
tests/responses-background-lifecycle.test.ts	✅ Passed	141ms
tests/responses-body-method-errors.test.ts	✅ Passed	191ms
tests/responses-cancel-timeout.test.ts	✅ Passed	202ms
tests/responses-cancel.test.ts	✅ Passed	147ms
tests/responses-compact-retries.test.ts	✅ Passed	218ms
tests/responses-compact.test.ts	✅ Passed	162ms
tests/responses-create-advanced-stream.test.ts	✅ Passed	119ms
tests/responses-create-advanced.test.ts	✅ Passed	205ms
tests/responses-create-disconnect.test.ts	✅ Passed	1.083s
tests/responses-create-errors.test.ts	✅ Passed	143ms
tests/responses-create-malformed-api-responses.test.ts	✅ Passed	158ms
tests/responses-create-retries.test.ts	✅ Passed	483ms
tests/responses-create-stream-failures.test.ts	✅ Passed	88ms
tests/responses-create-stream-timeout.test.ts	✅ Passed	210ms
tests/responses-create-stream-wire.test.ts	✅ Passed	1.574s
tests/responses-create-stream.test.ts	✅ Passed	278ms
tests/responses-create-terminal-states.test.ts	✅ Passed	222ms
tests/responses-create-timeout.test.ts	✅ Passed	218ms
tests/responses-create.test.ts	✅ Passed	175ms
tests/responses-delete.test.ts	✅ Passed	157ms
tests/responses-input-items-errors.test.ts	✅ Passed	325ms
tests/responses-input-items-list.test.ts	✅ Passed	221ms
tests/responses-input-items-options.test.ts	✅ Passed	242ms
tests/responses-input-tokens-count-timeout.test.ts	✅ Passed	214ms
tests/responses-input-tokens-count.test.ts	✅ Passed	134ms
tests/responses-malformed-inputs.test.ts	✅ Passed	766ms
tests/responses-not-found-errors.test.ts	✅ Passed	197ms
tests/responses-parse.test.ts	✅ Passed	259ms
tests/responses-retrieve-retries.test.ts	✅ Passed	176ms
tests/responses-retrieve.test.ts	✅ Passed	171ms
tests/responses-stored-method-errors.test.ts	✅ Passed	382ms
tests/retry-behavior.test.ts	✅ Passed	3.121s
tests/sdk-error-shape.test.ts	✅ Passed	188ms

View OkTest run #39370838717

_{SDK merge (c0028c998b69) · head (d474b66516a2) · base (0e5794dc48b8) · OkTest (5d04a66b7423)}

[github-actions]

Castiron custom code

Evaluated main: 0e5794dc48b8f8d51f6047f8a0b1814eb1e65850.

Trusted main policy: 0e5794dc48b8f8d51f6047f8a0b1814eb1e65850.

✅ No new custom-code files detected.

39 mixed files remain; 0 existing customizations changed.

Compared 0e5794dc48b8 → d474b66516a2. Generated baselines verified.

39 existing customizations unchanged

• api.md
• 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/environments/files.py
• src/openai/resources/beta/agents/sessions/artifacts.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/realtime/translations/translations.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/decision_input_image_param.py
• src/openai/types/decision_input_text_param.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/tool.py
• src/openai/types/responses/tool_param.py
• src/openai/types/webhooks/init.py
• src/openai/types/webhooks/live_call_incoming_webhook_event.py
• src/openai/types/webhooks/unwrap_webhook_event.py
• tests/api_resources/test_videos.py

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 39370921231 --repo openai/openai-python \
  --name castiron-custom-code-39370921231-1 --dir /tmp/castiron-custom-code-39370921231-1
git apply --stat /tmp/castiron-custom-code-39370921231-1/custom-code.patch
cat /tmp/castiron-custom-code-39370921231-1/custom-code.patch

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

git fetch --no-tags origin 0e5794dc48b8f8d51f6047f8a0b1814eb1e65850 d474b66516a20687ea7e100cba073dca06eac0e7
python3 scripts/castiron/custom_code_report.py report \
  --base 0e5794dc48b8f8d51f6047f8a0b1814eb1e65850 \
  --head d474b66516a20687ea7e100cba073dca06eac0e7 --fetch --require-head-hash --public \
  --out /tmp/castiron-custom-code-d474b66516a2
cat /tmp/castiron-custom-code-d474b66516a2/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