release: 4.69.3

[openai-sdks]

Automated Release PR

4.69.3 (2026-09-25)

Chores

• api: document files and uploads error responses (#1081) (69a4e21)
• api: document Responses not-found errors (#1080) (e8cbf5d)

Build System

• deps: bump Maven Publish to 0.34.0 (#910) (2cbf22c)
• deps: bump Shadow to 9.2.2 (#904) (09b8c60)
• deps: upgrade Kotlin declarations together to 2.2.21 (#1079) (465742d)

---

This PR was generated with Release Please. See documentation.

[openai-sdks]

OkTest Summary

✅ 236/236 SDK tests passed in 20.946s for Java SDK PR #1077.

Test results — 42 files

Test	Result	Time
tests/chat-completions-complex-body.test.ts	✅ Passed	838ms
tests/chat-completions-create.test.ts	✅ Passed	992ms
tests/chat-completions-stream.test.ts	✅ Passed	561ms
tests/files-content-binary.test.ts	✅ Passed	344ms
tests/files-create-multipart.test.ts	✅ Passed	282ms
tests/files-list-pagination.test.ts	✅ Passed	463ms
tests/initialize-config.test.ts	✅ Passed	228ms
tests/instance-isolation.test.ts	✅ Passed	221ms
tests/models-list.test.ts	✅ Passed	377ms
tests/responses-background-lifecycle.test.ts	✅ Passed	506ms
tests/responses-body-method-errors.test.ts	✅ Passed	721ms
tests/responses-cancel-timeout.test.ts	✅ Passed	279ms
tests/responses-cancel.test.ts	✅ Passed	505ms
tests/responses-compact-retries.test.ts	✅ Passed	604ms
tests/responses-compact.test.ts	✅ Passed	307ms
tests/responses-create-advanced-stream.test.ts	✅ Passed	495ms
tests/responses-create-advanced.test.ts	✅ Passed	2.556s
tests/responses-create-disconnect.test.ts	✅ Passed	1.119s
tests/responses-create-errors.test.ts	✅ Passed	352ms
tests/responses-create-malformed-api-responses.test.ts	✅ Passed	719ms
tests/responses-create-retries.test.ts	✅ Passed	1.005s
tests/responses-create-stream-failures.test.ts	✅ Passed	414ms
tests/responses-create-stream-timeout.test.ts	✅ Passed	279ms
tests/responses-create-stream-wire.test.ts	✅ Passed	7.444s
tests/responses-create-stream.test.ts	✅ Passed	586ms
tests/responses-create-terminal-states.test.ts	✅ Passed	714ms
tests/responses-create-timeout.test.ts	✅ Passed	286ms
tests/responses-create.test.ts	✅ Passed	356ms
tests/responses-delete.test.ts	✅ Passed	357ms
tests/responses-input-items-errors.test.ts	✅ Passed	953ms
tests/responses-input-items-list.test.ts	✅ Passed	427ms
tests/responses-input-items-options.test.ts	✅ Passed	261ms
tests/responses-input-tokens-count-timeout.test.ts	✅ Passed	415ms
tests/responses-input-tokens-count.test.ts	✅ Passed	291ms
tests/responses-malformed-inputs.test.ts	✅ Passed	5.976s
tests/responses-not-found-errors.test.ts	✅ Passed	717ms
tests/responses-parse.test.ts	✅ Passed	762ms
tests/responses-retrieve-retries.test.ts	✅ Passed	399ms
tests/responses-retrieve.test.ts	✅ Passed	522ms
tests/responses-stored-method-errors.test.ts	✅ Passed	1.093s
tests/retry-behavior.test.ts	✅ Passed	3.43s
tests/sdk-error-shape.test.ts	✅ Passed	485ms

View OkTest run #36103383401

_{SDK merge (04f1fea774d1) · head (b94724c4188d) · base (69a4e21ba368) · OkTest (bc2ef6ca05ab)}

[github-actions]

Castiron custom code

✅ No new custom-code files detected.

87 mixed files remain; 0 existing customizations changed.

Compared 69a4e21ba368 → b94724c4188d. Generated baselines verified.

87 existing customizations unchanged

• openai-java-core/src/main/kotlin/com/openai/models/audio/AudioResponseFormat.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/agents/vaults/credentials/CredentialAuth.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/agents/vaults/credentials/CredentialAuthCreateParam.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/agents/vaults/credentials/CredentialAuthRotateParam.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseStreamEvent.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponsesServerEvent.kt
• openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionCreateParams.kt
• openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionMessageFunctionToolCall.kt
• openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionToolMessageParam.kt
• openai-java-core/src/main/kotlin/com/openai/models/embeddings/Embedding.kt
• openai-java-core/src/main/kotlin/com/openai/models/embeddings/EmbeddingCreateParams.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCreateParams.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionToolCall.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionWebSearch.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputItem.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseStreamEvent.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseTextConfig.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponsesServerEvent.kt
• openai-java-core/src/main/kotlin/com/openai/models/videos/Video.kt
• openai-java-core/src/main/kotlin/com/openai/models/webhooks/UnwrapWebhookEvent.kt
• openai-java-core/src/main/kotlin/com/openai/models/webhooks/WebhookEndpointWithSecret.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsync.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/ImageServiceAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/ResponseServiceAsync.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/ResponseServiceAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/SkillServiceAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/VideoServiceAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/WebhookServiceAsync.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/WebhookServiceAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/audio/TranscriptionServiceAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/beta/agents/SessionServiceAsync.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/beta/agents/SessionServiceAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/chat/ChatCompletionServiceAsync.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/finetuning/checkpoints/PermissionServiceAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/skills/VersionServiceAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaService.kt
• openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaServiceImpl.kt
• openai-java-core/src/main/kotlin/com/openai/services/blocking/ResponseService.kt
• openai-java-core/src/main/kotlin/com/openai/services/blocking/ResponseServiceImpl.kt

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

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

git fetch --no-tags origin 69a4e21ba3686e83b084901febeffb42b818460b b94724c4188df09396115f5732396ff88caaf4af
python3 scripts/castiron/custom_code_report.py report \
  --base 69a4e21ba3686e83b084901febeffb42b818460b \
  --head b94724c4188df09396115f5732396ff88caaf4af --fetch --require-head-hash --public \
  --out /tmp/castiron-custom-code-b94724c4188d
cat /tmp/castiron-custom-code-b94724c4188d/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:

• v4.69.3

🌻