CHANGELOG.md

Changelog

4.26.0 (2026-03-05)

Full Changelog: v4.25.0...v4.26.0

Features

• api: The GA ComputerTool now uses the CompuerTool class. The 'computer_use_preview' tool is moved to ComputerUsePreview (a8d8de8)

Bug Fixes

• api: update structured response tool overloads (5562fc1)

4.25.0 (2026-03-05)

Full Changelog: v4.24.1...v4.25.0

Features

• api: gpt-5.4, tool search tool, and new computer tool (18c8870)

Bug Fixes

• api: allow unknown video seconds in responses (82d67cb)

Chores

• internal: codegen related update (42a435d)

4.24.1 (2026-03-04)

Full Changelog: v4.24.0...v4.24.1

Bug Fixes

• api: internal schema fixes (b4d6777)
• api: manual updates (95d5732)
• java: add missing phase delegates to structured response output wrapper (9c61370)

Chores

• internal: codegen related update (e5c572f)
• internal: reduce warnings (445d1ad)

4.24.0 (2026-02-24)

Full Changelog: v4.23.0...v4.24.0

Features

• api: add phase (28dfb07)
• api: remove phase from messages and promptCacheKey parameter (6eb0909)

Bug Fixes

• api: fix phase enum (9217829)
• api: phase docs (215079e)
• api: readd phase (9d234b2)

Chores

• internal: expand imports (73adcb9)

4.23.0 (2026-02-23)

Full Changelog: v4.22.0...v4.23.0

Features

• api: add gpt-realtime-1.5 and gpt-audio-1.5 models to realtime session (b00b515)

Bug Fixes

• api: manual updates (bd83804)
• set Accept header in more places (9e2e714)
• tests: skip unsupported streaming tests (24f9854)

Chores

• drop apache dependency (37805bf)
• make Properties more resilient to null (0039eb0)

Documentation

• api: add batch size limit to file batch create parameters (764fd86)
• api: clarify safety_identifier max length in chat completions and responses (b2735b0)

4.22.0 (2026-02-19)

Full Changelog: v4.21.0...v4.22.0

Features

• client: add connection pooling option (6b5fd77)

Chores

• internal: make OkHttp constructor internal (a1e3ca6)
• internal: remove unnecessary base URL (360edde)
• internal: update TestServerExtension comment (41182d1)
• internal: update CI step name (eeb51c6)

Documentation

• api: update docstrings across audio, chatkit, skills, videos, and other endpoints (f5018f5)

4.21.0 (2026-02-13)

Full Changelog: v4.20.0...v4.21.0

Features

• api: container network_policy and skills (c248c52)

Documentation

• update comment (6a1a02b)

4.20.0 (2026-02-10)

Full Changelog: v4.19.0...v4.20.0

Features

• api: skills and hosted shell (fcd724d)
• api: support for images in batch api (c73908a)

4.19.0 (2026-02-09)

Full Changelog: v4.18.0...v4.19.0

Features

• api: add context_management to responses (da0fb59)
• api: add webhook signature verification (1823eca)
• api: responses context_management (c0f2cd1)

Chores

• internal: upgrade AssertJ (5c01787)

4.18.0 (2026-02-05)

Full Changelog: v4.17.0...v4.18.0

Features

• api: image generation actions for responses; ResponseFunctionCallArgumentsDoneEvent.name (a0cc1d8)

Bug Fixes

• client: undo change to web search Find action (7b2ebe5)
• client: update type for find_in_page action (2cde783)

Chores

• internal: allow passing args to ./scripts/test (ce2c0ed)

4.17.0 (2026-01-30)

Full Changelog: v4.16.1...v4.17.0

Features

• api: add shell_call_output status field (1e8a078)
• api: api updates (23a49f6)

Bug Fixes

• api: mark assistants as deprecated (a21625e)

Chores

• ci: upgrade actions/github-script (ddbc5a1)
• client: improve example values (f5941b5)

4.16.1 (2026-01-23)

Full Changelog: v4.16.0...v4.16.1

Bug Fixes

• client: preserve time zone in lenient date-time parsing (2dcc893)

Chores

• internal: correct cache invalidation for SKIP_MOCK_TESTS (4f7b317)

Documentation

• add comment for arbitrary value fields (2d87940)

4.16.0 (2026-01-21)

Full Changelog: v4.15.0...v4.16.0

Features

• api: api update (e5203e2)
• client: send X-Stainless-Kotlin-Version header (d77a171)

Bug Fixes

• client: disallow coercion from float to int (4332495)
• client: fully respect max retries (b2ac5ce)
• client: send retry count header for max retries 0 (b2ac5ce)
• date time deserialization leniency (35a4662)
• make ResponseAccumulator forwards compatible with new event types (d9dc902)

Chores

• ci: upgrade actions/setup-java (d739c6a)
• internal: clean up maven repo artifact script and add html documentation to repo root (763df3f)
• internal: depend on packages directly in example (b2ac5ce)
• internal: improve maven repo docs (005acfc)
• internal: support uploading Maven repo artifacts to stainless package server (24dd88f)
• internal: update actions/checkout version (64b074f)
• internal: update maven repo doc to include authentication (c00b703)
• test on Jackson 2.14.0 to avoid encountering FasterXML/jackson-databind#3240 in tests (35a4662)

4.15.0 (2026-01-09)

Full Changelog: v4.14.0...v4.15.0

Features

• api: add new Response completed_at prop (703a651)
• client: allow configuring dispatcher executor service (8e579d9)

Bug Fixes

• client: allow withOptions to modify credentials (#674) (1d5a8f9)

Chores

• internal: use different example values for some enums (d8c6ed4)

4.14.0 (2026-01-06)

Full Changelog: v4.13.0...v4.14.0

Features

• client: add HttpRequest#url() method (cf7d459)

4.13.0 (2025-12-19)

Full Changelog: v4.12.0...v4.13.0

Features

• api: gpt-image-1.5 (165b588)
• api: slugs for new audio models; make all model params accept strings (cf46781)

4.12.0 (2025-12-15)

Full Changelog: v4.11.0...v4.12.0

Features

• api: api update (29174d7)
• api: fix grader input list, add dated slugs for sora-2 (f75af83)
• api: manual updates for java (ffd07a2)

4.11.0 (2025-12-12)

Full Changelog: v4.10.0...v4.11.0

Features

• api: gpt 5.2 (de55bd3)

4.10.0 (2025-12-10)

Full Changelog: v4.9.0...v4.10.0

Features

• api: make model required for the responses/compact endpoint (904f55a)

4.9.0 (2025-12-04)

Full Changelog: v4.8.0...v4.9.0

Features

• api: gpt-5.1-codex-max and responses/compact (651c44f)

Bug Fixes

• api: align types of input items / output items for typescript (9202c69)
• client: cancel okhttp call when future cancelled (c665e21)

Documentation

• remove $ for better copy-pasteabality (66f7a4b)

4.8.0 (2025-11-13)

Full Changelog: v4.7.2...v4.8.0

Features

• api: gpt 5.1 (bb89ad7)

4.7.2 (2025-11-13)

Full Changelog: v4.7.1...v4.7.2

Bug Fixes

• client: multi-value header serialization (4a198b2)

4.7.1 (2025-11-04)

Full Changelog: v4.7.0...v4.7.1

Bug Fixes

• api: fix nullability of logprobs (f1733f8)

4.7.0 (2025-11-04)

Full Changelog: v4.6.1...v4.7.0

Features

• api: Realtime API token_limits, Hybrid searching ranking options (bd9bcfd)
• api: remove InputAudio from ResponseInputContent (630fecf)

Bug Fixes

• api: docs updates (3e970ec)

4.6.1 (2025-10-20)

Full Changelog: v4.6.0...v4.6.1

Bug Fixes

• api: fix discriminator propertyName for ResponseFormatJsonSchema (a54219b)

4.6.0 (2025-10-20)

Full Changelog: v4.5.0...v4.6.0

Features

• api: Add responses.input_tokens.count (4cc3097)

Bug Fixes

• api: internal openapi updates (faead94)

4.5.0 (2025-10-17)

Full Changelog: v4.4.0...v4.5.0

Features

• api: api update (09dd95f)

4.4.0 (2025-10-16)

Full Changelog: v4.3.0...v4.4.0

Features

• api: Add support for gpt-4o-transcribe-diarize on audio/transcriptions endpoint (dc2c297)

4.3.0 (2025-10-10)

Full Changelog: v4.2.0...v4.3.0

Features

• add more helper methods to instantiate union objects (e5e61b5)
• api: comparison filter in/not in (29b6606)

Bug Fixes

• api: manual updates (8d54d5d)

4.2.0 (2025-10-06)

Full Changelog: v4.1.0...v4.2.0

Features

• api: dev day 2025 launches (d4f0999)

4.1.0 (2025-10-02)

Full Changelog: v4.0.1...v4.1.0

Features

• api: add support for realtime calls (c4d224c)

4.0.1 (2025-10-01)

Full Changelog: v4.0.0...v4.0.1

Bug Fixes

• api: add status, approval_request_id to MCP tool call (56ed867)

4.0.0 (2025-09-30)

Full Changelog: v3.7.1...v4.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 (de7a6c1)

Bug Fixes

• client: remove duplicate outputAsJson function (4718871)

3.7.1 (2025-09-26)

Full Changelog: v3.7.0...v3.7.1

Bug Fixes

• client: deserialization of empty objects (9a1f927)

Chores

• internal: change some comment formatting (3ae2e58)

3.7.0 (2025-09-23)

Full Changelog: v3.6.1...v3.7.0

Features

• api: gpt-5-codex (cf7d02f)

3.6.1 (2025-09-22)

Full Changelog: v3.6.0...v3.6.1

Bug Fixes

• api: fix mcp tool name (d2e947d)

Chores

• api: openapi updates for conversations (0dbcc0a)
• improve example values (109a350)
• improve formatter performance (3fce946)

3.6.0 (2025-09-19)

Full Changelog: v3.5.3...v3.6.0

Features

• api: add reasoning_text (2bde290)
• api: type updates for conversations, reasoning_effort and results for evals (364a176)
• client: expose sleeper option (a5ffd57)

Bug Fixes

• client: ensure single timer is created per client (a5ffd57)

3.5.3 (2025-09-15)

Full Changelog: v3.5.2...v3.5.3

Bug Fixes

• client: incorrect getPackageVersion impl (51a0e59)

Chores

• api: docs and spec refactoring (02720cf)

3.5.2 (2025-09-12)

Full Changelog: v3.5.1...v3.5.2

Chores

• api: Minor docs and type updates for realtime (63ad148)
• improve formatter performance (be0acb7)
• internal: codegen related update (18a0e64)
• internal: codegen related update (ab87009)
• internal: remove redundant deserializer symbols (8c63a5b)

3.5.1 (2025-09-10)

Full Changelog: v3.5.0...v3.5.1

Chores

• api: fix realtime GA types (10cd1c4)

3.5.0 (2025-09-08)

Full Changelog: v3.4.1...v3.5.0

Features

• api: ship the RealtimeGA API shape (4eb0dfa)

3.4.1 (2025-09-03)

Full Changelog: v3.4.0...v3.4.1

Bug Fixes

• ci: use java-version 21 for publish step (db861bd)

3.4.0 (2025-09-03)

Full Changelog: v3.3.0...v3.4.0

Features

• api: Add gpt-realtime models (37b8b69)

3.3.0 (2025-09-03)

Full Changelog: v3.2.1...v3.3.0

Features

• client: support verbosity with structured outputs (#603) (2496464)

3.2.1 (2025-09-02)

Full Changelog: v3.2.0...v3.2.1

Chores

• api: manual updates for ResponseInputAudio (d070eb7)

3.2.0 (2025-09-02)

Full Changelog: v3.1.2...v3.2.0

Features

• api: Add connectors support for MCP tool (ee175a9)
• api: add web search filters (45c5856)
• api: adding support for /v1/conversations to the API (9d088c5)
• api: realtime API updates (0ea523e)

Bug Fixes

• fix casing issue (201f54e)
• update singularization rules (7cbc830)

Chores

• add missing delegate methods (557e9ee)
• ci: reduce log noise (9e91952)
• client: refactor closing / shutdown (94cdfcd)
• internal: support running formatters directly (6242da5)
• remove memory upper bound from publishing step (fdc5fdd)

3.1.2 (2025-08-20)

Full Changelog: v3.1.1...v3.1.2

Bug Fixes

• client: ensure correct binary content type (86386c9)

Chores

• client: rename parameter (86386c9)
• internal: fix multipart tests (ea67d5d)

3.1.1 (2025-08-20)

Full Changelog: v3.1.0...v3.1.1

Chores

• internal/ci: setup breaking change detection (2a18622)

3.1.0 (2025-08-19)

Full Changelog: v3.0.3...v3.1.0

Features

• api: add new text parameters, expiration options (658f053)

Performance Improvements

• internal: make formatting faster (d7909d9)

Chores

• api: accurately represent shape for verbosity on Chat Completions (d01f37f)
• ci: add build job (7699c4f)
• internal: dynamically determine included projects (1342647)
• internal: support passing arguments to test script (ac596c6)

3.0.3 (2025-08-13)

Full Changelog: v3.0.2...v3.0.3

Bug Fixes

• serialize dates correctly in structured outputs (8cd3639)

Chores

• internal: format identity methods (fd2661b)

Documentation

• add response raw structured outputs (e68d31e)

3.0.2 (2025-08-09)

Full Changelog: v3.0.1...v3.0.2

Chores

• internal: update comment in script (925656f)

3.0.1 (2025-08-08)

Full Changelog: v3.0.0...v3.0.1

Bug Fixes

• client: fix verbosity parameter location in Responses (c4200c3)
• responses: remove incorrect verbosity builder method (76286de)
• responses: remove more references to incorrect verbosity location (1f56089)

Chores

• update @stainless-api/prism-cli to v5.15.0 (61263de)
• update delegation tests (060ec4c)

3.0.0 (2025-08-08)

Full Changelog: v2.20.1...v3.0.0

Features

• api: adds GPT-5 and new API features: platform.openai.com/docs/guides/gpt-5 (fa34d24)
• api: manual updates (089a075)
• client: support new unified Azure URL scheme (#554) (9aacff0)

Bug Fixes

• functions: add accidentally removed arguments method (696dfb1)

Chores

• example: fix run example comment (42fe3d9)
• increase max gradle JVM heap to 8GB (87afac0)
• internal: add async lock helper (1a75cea)

Documentation

• more prominently call out examples (d601c1a)
• multiple image editing (a64f375)

2.20.1 (2025-07-31)

Full Changelog: v2.20.0...v2.20.1

Bug Fixes

• client: r8 support (aa76f63)

Chores

• internal: bump ci test timeout (0ea80f0)
• internal: reduce proguard ci logging (876aa8f)

2.20.0 (2025-07-30)

Full Changelog: v2.19.2...v2.20.0

Features

• add retryable exception (4916163)
• api: manual updates (c4f9a92)
• client: ensure compat with proguard (0d4db65)

2.19.2 (2025-07-28)

Full Changelog: v2.19.1...v2.19.2

Bug Fixes

• client: some bad _additionalBodyProperties serialization (ae900c6)

2.19.1 (2025-07-24)

Full Changelog: v2.19.0...v2.19.1

Bug Fixes

• client: accidental mutability of some classes (8f377c4)

Chores

• internal: remove unnecessary [...] in [@see](https://github.com/see) (ba7945f)
• internal: simplify handling of deployment models (#556) (2c7e661)

Documentation

• more code comments (2110f40)

2.19.0 (2025-07-23)

Full Changelog: v2.18.2...v2.19.0

Features

• client: support base64 embeddings and use as default (#519) (12b0ff7)

Documentation

• fix missing readme comment (720ed2c)

2.18.2 (2025-07-22)

Full Changelog: v2.18.1...v2.18.2

Bug Fixes

• client: support structured outputs in async requests (#548). (#550) (b9d52cf)

2.18.1 (2025-07-22)

Full Changelog: v2.18.0...v2.18.1

Bug Fixes

• actually add system properties (09bb653)

Documentation

• fix readme link (d98571c)

2.18.0 (2025-07-22)

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

Features

• client: add {QueryParams,Headers}#put(String, JsonValue) methods (1973f9a)
• client: allow configuring env via system properties (5f8deb3)

Chores

• api: event shapes more accurate (b7ba592)

2.17.0 (2025-07-21)

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

Features

• client: add https config options (3f74519)
• client: allow setting additional multipart body props (220503e)

Chores

• internal: refactor delegating from client to options (e89596d)

2.16.0 (2025-07-17)

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

Features

• client: publish GraalVM metadata files (#534) (e6b4fe0)

2.15.0 (2025-07-17)

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

Features

• client: add ResponseAccumulator (#391) (77f54fd)

Bug Fixes

• client: ensure error handling always occurs (a00c39b)

Chores

• client: remove non-existent method (2d185ba)
• internal: Add CONTRIBUTING.md for SDK developers (608947c)
• internal: allow running specific example from cli (3239c2d)

2.14.0 (2025-07-16)

Full Changelog: v2.13.1...v2.14.0

Features

• api: manual updates (d3dd5be)

Bug Fixes

• internal: add back addAssistantMessage (e27b476)
• internal: add back addAssistantMessage (d363245)

Chores

• api: update realtime specs (dd24c50)
• ci: bump actions/setup-java to v4 (e5112cd)

2.13.1 (2025-07-15)

Full Changelog: v2.13.0...v2.13.1

Chores

• api: update realtime specs, build config (babbf87)

2.13.0 (2025-07-15)

Full Changelog: v2.12.4...v2.13.0

Features

• client: support completions streaming structured outputs (#528) (2c8917b)

2.12.4 (2025-07-11)

Full Changelog: v2.12.3...v2.12.4

Chores

• api: specification cleanup (6fc0efd)
• internal: manual updates (53059a7)

2.12.3 (2025-07-11)

Full Changelog: v2.12.2...v2.12.3

Documentation

• add file + completions example (closes #483) (4a826ec)
• add image editing examples (closes #453) (6fa09ce)

2.12.2 (2025-07-10)

Full Changelog: v2.12.1...v2.12.2

Documentation

• add batch processing examples (#462) (#476) (d910267)

2.12.1 (2025-07-08)

Full Changelog: v2.12.0...v2.12.1

Chores

• ci: ensure docs generation always succeeds (54de202)

2.12.0 (2025-07-01)

Full Changelog: v2.11.0...v2.12.0

Features

• support new schema constraints for structured outputs (#520) (5c41ac5)

Bug Fixes

• ci: correct conditional (a8c7a16)
• client: don't close client on withOptions usage when original is gc'd (e0890e3)

Chores

• ci: only run for pushes and fork pull requests (8dc0179)

Documentation

• fix readme typoe (#521) (eb83a83)

Refactors

• internal: minor ClientOptionsTest change (a7379a2)

2.11.0 (2025-06-27)

Full Changelog: v2.10.0...v2.11.0

Features

• api: add realtime data models (38d8e89)

Chores

• add deploymentModel (60ffc59)

2.10.0 (2025-06-26)

Full Changelog: v2.9.1...v2.10.0

Features

• api: webhook and deep research support (79859a1)

Bug Fixes

• ci: release-doctor — report correct token name (da7f492)
• client: fix webhooks errors (8051535)

Chores

• api: remove unsupported property (2102d96)
• client: sync structured outputs features (cb5c638)
• docs: update README to include links to docs on Webhooks (5698e53)

2.9.1 (2025-06-25)

Full Changelog: v2.9.0...v2.9.1

Chores

• internal: add tests for breaking change detection (b0a6eeb)
• updated readme link (c0992cd)

2.9.0 (2025-06-23)

Full Changelog: v2.8.1...v2.9.0

Features

• api: make model and inputs not required to create response (87dd646)
• api: update api shapes for usage and code interpreter (c003f8d)

Bug Fixes

• client: bump max requests per host to max requests (5 -> 64) (a36d9f6)

2.8.1 (2025-06-18)

Full Changelog: v2.8.0...v2.8.1

Bug Fixes

• client: consider cognitiveservices.azure.com as azure (#470) (551bfc2)

2.8.0 (2025-06-17)

Full Changelog: v2.7.0...v2.8.0

Features

• api: add reusable prompt IDs (0767a2b)
• api: manual updates (ec235f7)
• client: implement per-endpoint base URL support (c87f1af)

Bug Fixes

• client: update StructuredResponse with Prompt details (a47219b)
• internal: run formatter (5757aa6)
• tests: fix required prop in test (e820c6f)

Chores

• ci: enable for pull requests (9c90b16)
• internal: codegen related update (3597aee)
• run formatter (426527b)
• run formatter (426527b)
• run formatter (899f79c)

2.7.0 (2025-06-10)

Full Changelog: v2.6.0...v2.7.0

Features

• api: Add o3-pro model IDs (48a685f)

2.6.0 (2025-06-09)

Full Changelog: v2.5.0...v2.6.0

Features

• api: Add tools and structured outputs to evals (f9d593c)

2.5.0 (2025-06-06)

Full Changelog: v2.4.0...v2.5.0

Features

• client: automatic schema generation and arg parsing for function calling (#497) (800dc8f)

2.4.0 (2025-06-03)

Full Changelog: v2.3.2...v2.4.0

Features

• api: add new realtime and audio models, realtime session options (898d2ad)

Chores

• internal: minor formatting change (f68c491)

2.3.2 (2025-06-02)

Full Changelog: v2.3.1...v2.3.2

Bug Fixes

• api: Fix evals and code interpreter interfaces (d7e2747)

2.3.1 (2025-06-02)

Full Changelog: v2.3.0...v2.3.1

Bug Fixes

• client: hasNextPage impl for some classes (32e968f)

2.3.0 (2025-05-29)

Full Changelog: v2.2.1...v2.3.0

Features

• api: Config update for pakrym-stream-param (55ae767)

Bug Fixes

• client: add missing deployment model param (#704) (37aa563)
• client: correctly send streaming discriminator param (b27559f)
• client: optional image deployment model param (a507f84)
• client: remove @MustBeClosed for future returning methods (2988157)
• client: return binary content from get /containers/{container_id}/files/{file_id}/content (787e12b)

2.2.1 (2025-05-27)

Full Changelog: v2.2.0...v2.2.1

Bug Fixes

• client: don't throw on absent error message (0d1e325)

2.2.0 (2025-05-23)

Full Changelog: v2.1.0...v2.2.0

Features

• api: remove deprecated endpoints from Java client (7b5acb5)

Bug Fixes

• examples: remove old examples (8fe838c)

Chores

• internal: fix release workflows (c66f725)

2.1.0 (2025-05-22)

Full Changelog: v2.0.0...v2.1.0

Features

• api: new streaming helpers for background responses (a82279d)

Bug Fixes

• internal: fix issues with new items in structured responses (931f7b8)
• tests: fix file test (a82adfd)

2.0.0 (2025-05-21)

Full Changelog: v1.6.1...v2.0.0

⚠ BREAKING CHANGES

• client: change precision of some numeric types
• client: extract auto pagination to shared classes
• client: Migration: - If you were referencing the AutoPager class on a specific *Page or *PageAsync type, then you should instead reference the shared AutoPager and AutoPagerAsync types, under the core package
  • AutoPagerAsync now has different usage. You can call .subscribe(...) on the returned object instead to get called back each page item. You can also call onCompleteFuture() to get a future that completes when all items have been processed. Finally, you can call .close() on the returned object to stop auto-paginating early
  • If you were referencing getNextPage or getNextPageParams:
    • Swap to nextPage() and nextPageParams()
    • Note that these both now return non-optional types (use hasNextPage() before calling these, since they will throw if it's impossible to get another page)

Features

• api: Add reinforcement fine-tuning api support (3a9fcbb)
• api: further updates for evals API (2b9d5bc)
• api: manual updates (005a643)
• api: responses x eval api (66327c5)
• api: Updating Assistants and Evals API schemas (02c6df6)
• client: allow providing some params positionally (1c6e875)
• client: extract auto pagination to shared classes (855d571)
• client: type safe structured outputs (#463) (e123fdd)

Bug Fixes

• add missing deploymentModel params (d9af1fb)
• client: properly support srt and vtt in audio transcriptions. (#472) (1e5bf3d)
• merge conflict (bf7e961)
• missing validity (301a38a)

Chores

• docs: grammar improvements (13b0fbc)
• internal: fix custom code (567c86e)

Documentation

• remove or fix invalid readme examples (fa9f7fc)

Refactors

• client: change precision of some numeric types (291b0f4)

1.6.1 (2025-05-08)

Full Changelog: v1.6.0...v1.6.1

Chores

• internal: remove flaky -Xbackend-threads=0 option (1aec858)

1.6.0 (2025-05-02)

Full Changelog: v1.5.1...v1.6.0

Features

• api: add image sizes, reasoning encryption (a4a7d53)

Chores

• internal: update java toolchain (eef415d)

Documentation

• add ImageGenerationExample (#457) (286b7d5)

1.5.1 (2025-04-27)

Full Changelog: v1.5.0...v1.5.1

Bug Fixes

• client: add missing convenience methods (616d69a)

Chores

• ci: only use depot for staging repos (7835140)
• ci: run on more branches and use depot runners (8b7a805)
• internal: java 17 -> 21 on ci (9f690e4)
• internal: use byteInputStream() in tests (616d69a)
• run formatter (5e78fa5)

Documentation

• add responses input file example (#446) (b94d404)

1.5.0 (2025-04-23)

Full Changelog: v1.4.1...v1.5.0

Features

• api: adding new image model support (545b900)

Chores

• ci: add timeout thresholds for CI jobs (579da9b)

1.4.1 (2025-04-17)

Full Changelog: v1.4.0...v1.4.1

Bug Fixes

• internal: release flow (777a756)
• internal: test compilation error (544a4ce)

1.4.0 (2025-04-17)

Full Changelog: v1.3.1...v1.4.0

Features

• api: add o3 and o4-mini model IDs (069db4f)

Performance Improvements

• internal: improve compilation+test speed (ef38b5b)

Documentation

• explain http client customization (da22f7d)
• explain jackson compat in readme (6bc1dbd)

1.3.1 (2025-04-16)

Full Changelog: v1.3.0...v1.3.1

Documentation

• client: update jackson compat error message (e928c2d)
• update documentation links to be more uniform (e9bb6bf)

1.3.0 (2025-04-14)

Full Changelog: v1.2.0...v1.3.0

Features

• api: adding gpt-4.1 family of model IDs (cdddc6a)

Chores

• internal: reduce CI branch coverage (ac1f4e9)

1.2.0 (2025-04-09)

Full Changelog: v1.1.1...v1.2.0

Features

• client: make pagination robust to missing data (cbccde5)

Documentation

• add comments for page methods (cbccde5)

Refactors

• client: deduplicate page response classes (#433) (cbccde5)
• client: migrate pages to builder pattern (#435) (8cb8878)

1.1.1 (2025-04-09)

Full Changelog: v1.1.0...v1.1.1

Bug Fixes

• client: bump to better jackson version (#432) (b4ec1d1)

Chores

• internal: expand CI branch coverage (#429) (7ecece7)

1.1.0 (2025-04-09)

Full Changelog: v1.0.0...v1.1.0

Features

• client: support setting base URL via env var (#427) (d462b34)

1.0.0 (2025-04-09)

Full Changelog: v0.45.0...v1.0.0

Chores

• workaround build errors (6c6faa0)

Documentation

• remove beta readme note (829fb0a)

0.45.0 (2025-04-09)

Full Changelog: v0.44.5...v0.45.0

Features

• api: Add evalapi to sdk (b567998)

Bug Fixes

• client: trim '/' and empty character in base URL (#424) (37370df)

Chores

• add missing deploymentModel (acb132e)
• tests: improve enum examples (#416) (a698758)

0.44.5 (2025-04-08)

Full Changelog: v0.44.4...v0.44.5

Bug Fixes

• client: fix some bad identifiers (#413) (e567213)

0.44.4 (2025-04-07)

Full Changelog: v0.44.3...v0.44.4

Chores

• internal: only run examples workflow in main repo (#410) (058008a)

0.44.3 (2025-04-06)

Full Changelog: v0.44.2...v0.44.3

Bug Fixes

• client: return Optional<T> instead of Optional<? extends T> (#407) (73eee4f)

Chores

• internal: add more streamHandler tests (#404) (a29b341)
• internal: swap from getNullable to getOptional (#406) (32b54f9)

Documentation

• add comments to JsonField classes (73eee4f)
• document how to forcibly omit required field (a51c184)
• swap examples used in readme (#408) (a51c184)

0.44.2 (2025-04-04)

Full Changelog: v0.44.1...v0.44.2

Bug Fixes

• client: support responses API for Azure (#387) (f7f09aa)

0.44.1 (2025-04-04)

Full Changelog: v0.44.0...v0.44.1

Bug Fixes

• client: accumulation of tool call functions (#382) (#399) (943e6fb)

0.44.0 (2025-04-04)

Full Changelog: v0.43.0...v0.44.0

Features

• api: manual updates (331ec66)

Bug Fixes

• client: translate streaming IOException into custom exception (#397) (bc5c577)

Performance Improvements

• client: cached parsed type in HttpResponseFor (#395) (259b75a)

0.43.0 (2025-04-02)

Full Changelog: v0.42.0...v0.43.0

Features

• api: manual updates (9679525)
• client: expose request body setter and getter (#392) (eaa0bc9)

Chores

• internal: codegen related update (#389) (b0e9d31)

0.42.0 (2025-04-02)

Full Changelog: v0.41.1...v0.42.0

Features

• api: manual updates (0440105)
• client: add enum validation method (a641218)
• client: make union deserialization more robust (#385) (a641218)

Chores

• client: remove unnecessary json state from some query param classes (a641218)
• internal: add invalid json deserialization tests (a641218)
• internal: add json roundtripping tests (a641218)

0.41.1 (2025-04-01)

Full Changelog: v0.41.0...v0.41.1

Chores

• Remove deprecated/unused remote spec feature (4d3b56e)

0.41.0 (2025-03-31)

Full Changelog: v0.40.1...v0.41.0

Features

• client: improve some method names (#379) (895f99a)

Bug Fixes

• client: limit json deserialization coercion (#377) (5234cf9)

0.40.1 (2025-03-28)

Full Changelog: v0.40.0...v0.40.1

Bug Fixes

• client: don't call validate() during deserialization if we don't have to (#372) (1dae9bf)

Documentation

• add comment on response header methods (#374) (80bba20)
• document request IDs (3e2fec3)

0.40.0 (2025-03-27)

Full Changelog: v0.39.0...v0.40.0

Features

• api: add get /responses/{response_id}/input_items endpoint (#367) (c569175)
• client: add new responses endpoint (#369) (f15b5ee)

Bug Fixes

• deploymentModel arg (139c062)

0.39.0 (2025-03-27)

Full Changelog: v0.38.0...v0.39.0

Features

• api: add get /chat/completions endpoint (#364) (8591689)

Bug Fixes

• add missing deploymentModel (40c568f)

0.38.0 (2025-03-27)

Full Changelog: v0.37.0...v0.38.0

Features

• client: add chat completion streaming helper (#354) (561c085)

Bug Fixes

• client: map deserialization bug (caa79a2)

Chores

• add hash of OpenAPI spec/config inputs to .stats.yml (d27646c)
• api: updates to supported Voice IDs (#361) (fd0d45a)
• internal: delete unused methods and annotations (#362) (caa79a2)

0.37.0 (2025-03-25)

Full Changelog: v0.36.0...v0.37.0

Features

• client: support a lower jackson version (#357) (13a3c67)
• client: throw on incompatible jackson version (13a3c67)

Chores

• internal: fix example formatting (#348) (44a7df9)
• internal: remove unnecessary import (#349) (661a906)

Documentation

• minor readme tweak (#351) (28a1116)
• responses image url example (d84abd4)
• update readme exception docs (#350) (b441223)

0.36.0 (2025-03-21)

Full Changelog: v0.35.1...v0.36.0

⚠ BREAKING CHANGES

• client: refactor exception structure and methods (#336)

Features

• api: new models for TTS, STT, + new audio features for Realtime (#340) (630d63c)
• api: o1-pro now available through the API (#337) (93a7949)

Bug Fixes

• add missing deployment models (0f5c072)
• client: compilation error in adding streaming discriminator (#342) (f26276e)
• client: remove duplicate types (#341) (e6b3e76)

Chores

• client: refactor exception structure and methods (#336) (552fcf2)
• internal: add missing release please block (#335) (3312a39)
• internal: make multipart assertions more robust (badd931)
• internal: remove unnecessary assertNotNull calls (badd931)
• internal: version bump (#333) (7f09373)

Documentation

• refine comments on multipart params (#343) (badd931)

0.35.1 (2025-03-18)

Full Changelog: v0.35.0...v0.35.1

Bug Fixes

• api: correct some Responses types (#328) (efc79c0)
• client: support kotlin 1.8 runtime (#330) (5179a4e)
• types: improve responses type names (#332) (517c500)

Chores

• internal: add back release workflow (7893465)
• internal: codegen related update (#327) (7030355)
• internal: refactor enum query param serialization (#331) (c5ef44d)

Documentation

• responses conversation example (fde5110)
• show function calling conversation (#227) (ff7905a)

0.35.0 (2025-03-18)

Full Changelog: v0.34.1...v0.35.0

Features

• client: don't require params for some service methods (#325) (3ed7cf8)

Chores

• internal: add generated comment (#318) (44a46b5)
• internal: add some tests for union classes (#326) (bd92f57)
• internal: delete duplicate tests (f95f8bc)
• internal: generate more tests (a05b899)
• internal: make test classes internal (#317) (f9a25b4)
• internal: refactor query param serialization impl and tests (#322) (93558fc)
• internal: refactor some test assertions (f95f8bc)
• internal: reformat some tests (#324) (a05b899)
• internal: remove CI condition (#310) (1cb3294)
• internal: rename getPathParam (#323) (f95f8bc)
• internal: reorder some params methodsc (f95f8bc)
• internal: update release workflows (2b0d392)

Documentation

• add build method comments (#321) (31a8e9e)
• deduplicate and refine comments (#313) (3e0b2f5)
• image url example (39695e4)

0.34.1 (2025-03-11)

Full Changelog: v0.34.0...v0.34.1

Bug Fixes

• responses: correct computer use enum value (#298) (5ad3f2a)
• responses: correct reasoning output type (#300) (77572c6)

0.34.0 (2025-03-11)

Full Changelog: v0.33.0...v0.34.0

⚠ BREAKING CHANGES

• client: move classes into subpackages and shorten names (#294)

Features

• api: add /v1/responses and built-in tools (#296) (3216ffa)

Chores

• add deploymentModel to new endpoints (2d98165)
• client: move classes into subpackages and shorten names (#294) (1a65445)
• internal: add .kotlin to .gitignore (#285) (46c9b3a)
• internal: don't use JvmOverloads in interfaces (9b04bb9)
• internal: reenable warnings as errors (#288) (9b04bb9)
• internal: use getOrNull instead of orElse(null) (#287) (8eeec84)

Documentation

• document JsonValue construction in readme (#292) (4453173)
• fix examples (0dfd4b1)
• make URL purpose clearer in readme (#289) (88df036)
• responses examples (589ea32)
• revise readme docs about nested params (#291) (d3df21f)

0.33.0 (2025-03-06)

Full Changelog: v0.32.0...v0.33.0

Features

• client: detect binary incompatible jackson versions (#282) (10eca3f)

Chores

• ci: run more examples (4815776)

0.32.0 (2025-03-06)

Full Changelog: v0.31.1...v0.32.0

Features

• client: accept InputStream and Path for file params (3fda365)
• client: accept InputStream and Path for file params (#277) (04f2d3c)

Documentation

• document file uploads in readme (#279) (96e4969)

0.31.1 (2025-03-05)

Full Changelog: v0.31.0...v0.31.1

Bug Fixes

• api: add missing file rank enum + more metadata (#276) (e92512f)

Chores

• client: expose Optional, not nullable, from ClientOptions (#274) (c029310)

Documentation

• add audio transcription example (2c6a1aa)
• embeddings example (#263) (e1b68de)
• note required fields in builder javadoc (#272) (603b5c9)

0.31.0 (2025-03-04)

Full Changelog: v0.30.0...v0.31.0

Features

• client: add file upload endpoints (#268) (456274d)
• client: allow configuring timeouts granularly (#266) (c3bc6e4)

Chores

• internal: refactor ErrorHandlingTest (#264) (2472f85)
• internal: run example files in CI (#271) (8da7851)

Documentation

• add raw response readme documentation (#269) (2839903)
• update URLs from stainlessapi.com to stainless.com (#259) (b824bf3)

0.30.0 (2025-02-27)

Full Changelog: v0.29.0...v0.30.0

Features

• api: add gpt-4.5-preview (#258) (27d1e7f)

Chores

• client: use deep identity methods for primitive array types (#255) (fac8678)
• internal: add async service tests (#253) (147872a)
• internal: improve sync service tests (147872a)
• internal: refactor ServiceParamsTest (#257) (9cb1929)

Documentation

• readme parameter tweaks (147872a)

0.29.0 (2025-02-26)

Full Changelog: v0.28.0...v0.29.0

Features

• client: allow omitting params object when none required (#249) (e77a6c3)

Bug Fixes

• client: add missing @JvmStatic (#252) (06231c2)

Chores

• internal: remove unused variable (#251) (b41bc4e)

Documentation

• switch to .list() without arguments in examples (d1480f1)

0.28.0 (2025-02-24)

Full Changelog: v0.27.0...v0.28.0

Features

• api: add latest stable/preview version helper methods (#226) (9766b7c)

Documentation

• add source file links to readme (#247) (d9b67d7)

0.27.0 (2025-02-24)

Full Changelog: v0.26.1...v0.27.0

Features

• docs: moderations example (#245) (3108fee)

0.26.1 (2025-02-21)

Full Changelog: v0.26.0...v0.26.1

Documentation

• add immutability explanation to readme (#243) (5826fb0)

0.26.0 (2025-02-20)

Full Changelog: v0.25.0...v0.26.0

Features

• client: add an AsyncStreamResponse#onCompleteFuture() method (#239) (9aeddf8)

Bug Fixes

• client: mark some request bodies as optional (#242) (e3c5d67)
• client: prevent IOException when closing stream early (#241) (1e174e3)

Chores

• docs: add faq to readme (#240) (6bb4122)
• internal: remove unnecessary non-null asserts in tests (e3c5d67)
• internal: use assertNotNull in tests for type narrowing (e3c5d67)

Documentation

• add more documentation to AsyncStreamResponse (9aeddf8)
• add stream cancellation example (ddeabe0)
• remove unnecessary catch clauses in readme (#238) (8c86b99)
• remove unnecessary checked exception signatures (e26ee05)
• use onCompleteFuture() in examples (c244f17)

0.25.0 (2025-02-20)

Full Changelog: v0.24.1...v0.25.0

Features

• client: get rid of annoying checked exceptions (#236) (4c60942)

Chores

• ci: update gradle actions to v4 (#234) (fbcf865)

0.24.1 (2025-02-20)

Full Changelog: v0.24.0...v0.24.1

Bug Fixes

• client: add missing streamHandlerExecutor method (#230) (d53a08a)

Chores

• docs: add binary responses info to readme (#231) (6ae25b4)
• docs: add streaming info to readme (d53a08a)
• docs: reorganize readme (#228) (7d92206)
• internal: get rid of configuration cache (#233) (d95c380)

0.24.0 (2025-02-18)

Full Changelog: v0.23.1...v0.24.0

Features

• client: support JsonField#asX() for known values (#225) (31c0663)
• client: update enum asX methods (#224) (b06a749)

Chores

• internal: make body class constructors private (7c6739c)
• internal: make body classes for multipart requests (7c6739c)
• internal: misc formatting changes (7c6739c)
• internal: optimize build and test perf (fc6bcd7)
• internal: rename internal body classes (7c6739c)
• internal: update formatter (#220) (fc6bcd7)
• internal: update some formatting in Values.kt (31c0663)
• internal: use better test example values (#222) (7c6739c)

0.23.1 (2025-02-15)

Full Changelog: v0.23.0...v0.23.1

Bug Fixes

• add missing argument (5a6d2a2)

0.23.0 (2025-02-14)

Full Changelog: v0.22.1...v0.23.0

Features

• api: add support for storing chat completions (#216) (68a7883)

0.22.1 (2025-02-12)

Full Changelog: v0.22.0...v0.22.1

Documentation

• function calling example (#213) (89700ec)

0.22.0 (2025-02-06)

Full Changelog: v0.21.1...v0.22.0

Features

• api: Add more new Azure service versions (#208) (a117892)
• pagination: avoid fetching when has_more: false (#209) (183b132)

Bug Fixes

• api: add missing @MustBeClosed annotations (#205) (0a60b9a)
• api: add missing reasoning effort + model enums (#207) (8eb2394)
• api: switch CompletableFuture<Void> to CompletableFuture<Void?> (0a60b9a)
• client: add missing validation calls on response (0a60b9a)
• client: always provide a body for PATCH methods (0a60b9a)
• deploymentModel arg (3ab4110)

Chores

• internal: minor formatting/style changes (0a60b9a)
• internal: rename some tests (0a60b9a)

0.21.1 (2025-02-05)

Full Changelog: v0.21.0...v0.21.1

Bug Fixes

• api/types: correct audio duration & role types (#199) (5b57a0d)

0.21.0 (2025-02-05)

Full Changelog: v0.20.0...v0.21.0

Features

• api: add file content endpoint (#198) (3dd469f)
• client: send client-side timeout headers (#196) (03706d4)

Bug Fixes

• add deploymentModel (38e173d)

0.20.0 (2025-01-31)

Full Changelog: v0.19.0...v0.20.0

Features

• api: add o3-mini (#192) (e10c532)

Bug Fixes

• types: correct metadata type + other fixes (e10c532)

0.19.0 (2025-01-30)

Full Changelog: v0.18.1...v0.19.0

Features

• client: helpers for discriminated classes with one required prop (#189) (adbf4b0)

Documentation

• fix incorrect additional properties info (#190) (3d443f7)
• update breaking change expectations (ee4ee2b)

0.18.1 (2025-01-29)

Full Changelog: v0.18.0...v0.18.1

Bug Fixes

• client: don't leak responses when retrying (#185) (a13f967)

0.18.0 (2025-01-29)

Full Changelog: v0.17.0...v0.18.0

Features

• client: helpers for discriminated union variants with one required prop (#182) (ec756b9)

Chores

• internal: improve RetryingHttpClientTest (#180) (b7ebe5d)
• internal: simplify object construction (#183) (3d5a59d)

Documentation

• simpliy param construction (2c2ccbc)

0.17.0 (2025-01-29)

Full Changelog: v0.16.0...v0.17.0

Features

• client: add _queryParams and _headers methods (#177) (2d67005)

Refactors

• internal: extract request preparation logic (2d67005)

0.16.0 (2025-01-28)

Full Changelog: v0.15.1...v0.16.0

Features

• client: add some more builder helpers (#173) (f314e68)

Chores

• internal: shorten model method impl (f314e68)

Documentation

• mark more methods as deprecated (f314e68)
• more examples and cleanup (#159) (fa2a1fc)

0.15.1 (2025-01-27)

Full Changelog: v0.15.0...v0.15.1

Documentation

• builder, enum, and union comments (#171) (37acbbd)

0.15.0 (2025-01-27)

Full Changelog: v0.14.1...v0.15.0

Features

• client: add close method (#164) (f32975f)

Bug Fixes

• client: make some classes and constructors non-public (#169) (20fb5a1)

Chores

• internal: remove some unnecessary constructor keywords (20fb5a1)

Documentation

• async and sync method comments (#167) (6f11e5d)
• add client documentation (#166) (4344883)

0.14.1 (2025-01-25)

Full Changelog: v0.14.0...v0.14.1

Bug Fixes

• client: async streaming flakiness (#162) (247c05a)

Chores

• add max retries to test (#160) (7c4a4e0)
• internal: fix release (#163) (987fa44)

0.14.0 (2025-01-24)

Full Changelog: v0.13.0...v0.14.0

⚠ BREAKING CHANGES

• client: better union variant method and variable names (#157)

Features

• client: better union variant method and variable names (#157) (da5bce5)

Bug Fixes

• examples (3473781)

Chores

• internal: swap checkNotNull to checkRequired (#156) (d6f65f7)

Documentation

• move up requirements section (#154) (48fc646)
• update readme (#152) (293dc47)

0.13.0 (2025-01-22)

Full Changelog: v0.12.0...v0.13.0

Features

• api: update enum values, comments, examples, and constants (#149) (4bfa305)

Bug Fixes

• examples: remove now unneeded role param (045f141)

0.12.0 (2025-01-22)

Full Changelog: v0.11.10...v0.12.0

Features

• client: make it easy to roundtrip messages (#148) (f4a1617)

Bug Fixes

• client: bad assistants v2 deserialization (#146) (59d6de8)

0.11.10 (2025-01-21)

Full Changelog: v0.11.9...v0.11.10

Bug Fixes

• client: add missing default headers (#145) (18d5270)

0.11.9 (2025-01-21)

Full Changelog: v0.11.8...v0.11.9

Bug Fixes

• client: make service impl constructors internal (#141) (da35557)

0.11.8 (2025-01-17)

Full Changelog: v0.11.7...v0.11.8

Documentation

• fix javadoc.io link (ba07770)
• fix javadoc.io link again (0d2b8ce)

0.11.7 (2025-01-17)

Full Changelog: v0.11.6...v0.11.7

Chores

• internal: upgrade kotlin compiler and gradle (#132) (61a0b0d)

Documentation

• add javadoc.io badge (#135) (e905ce5)
• add more documentation (#134) (893eafc)

0.11.6 (2025-01-17)

Full Changelog: v0.11.5...v0.11.6

Chores

• internal: move StreamResponse method (#131) (5888e39)
• internal: refactor streaming implementation (#129) (d2831ec)

0.11.5 (2025-01-16)

Full Changelog: v0.11.4...v0.11.5

Bug Fixes

• internal: publishing error (73e22ea)

0.11.4 (2025-01-16)

Full Changelog: v0.11.3...v0.11.4

Chores

• internal: add and tweak check functions (#117) (627cb56)
• internal: extract a checkRequired function (#113) (b63b2b1)
• internal: fix tests (61ada05)
• internal: remove space (#125) (27bfcec)
• internal: remove unused gradle task (#121) (0b4e59a)
• internal: tweak client options nullability handling (627cb56)
• simplify examples involving lists (#118) (557c071)
• simplify examples involving unions (#119) (7c7795c)
• types: rename vector store chunking strategy (#116) (387935f)

Documentation

• don't mention a non-existent SDK (#120) (23eb658)

0.11.3 (2025-01-14)

Full Changelog: v0.11.2...v0.11.3

Bug Fixes

• streaming: support assistants (#106) (bebfa9c)

Chores

• internal: fix up root build.gradle.kts formatting (#109) (54a806f)
• internal: remove unused Gradle imports (#110) (22502eb)
• internal: remove unused or unnecessary Gradle imports (#111) (8d95893)
• tests: add more tests for streaming (#108) (5dec143)

Documentation

• publish dokka javadoc (#112) (5521ffc)

0.11.2 (2025-01-10)

Full Changelog: v0.11.1...v0.11.2

Bug Fixes

• client: add some missing validate() calls (#101) (dec2d6b)

Chores

• internal: refactor validate methods (dec2d6b)

0.11.1 (2025-01-09)

Full Changelog: v0.11.0...v0.11.1

Chores

• internal: add some missing newlines between methods (#100) (afc2998)
• internal: spec update (#97) (0cff792)

Documentation

• update some builder method javadocs (#99) (192965a)

0.11.0 (2025-01-08)

Full Changelog: v0.10.0...v0.11.0

Features

• client: add more builder convenience methods for lists (#96) (9ee703b)

Documentation

• readme: fix misplaced period (#94) (c6242ba)

0.10.0 (2025-01-08)

Full Changelog: v0.9.1...v0.10.0

Features

• client: add various convenience setters to models (#91) (9b3eb17)
• client: allow passing null or optional for nullable fields (#84) (8a8f2f9)
• client: allow setting arbitrary JSON for top-level body params (9b3eb17)
• client: expose getters for JsonField of body params (9b3eb17)

Bug Fixes

• client: consistently throw on omitting required fields (9b3eb17)
• client: convert JsonField containing list type to mutable in builder (9b3eb17)

Documentation

• add params class javadocs (#90) (9a33c1c)

Styles

• internal: explicitly add some method return types (9b3eb17)
• internal: move headers and query params setters below others (9b3eb17)
• internal: simplify existing convenience setters on params (9b3eb17)

0.9.1 (2025-01-06)

Full Changelog: v0.9.0...v0.9.1

Styles

• internal: sort fields (#82) (219b48f)

0.9.0 (2025-01-03)

Full Changelog: v0.8.1...v0.9.0

⚠ BREAKING CHANGES

• client: switch query params objects to use QueryParams (#64)

Features

• client: add beta endpoints (#79) (8584a20)
• client: put body field in params, add more convenience methods, and add missing docs (#77) (0c74350)

Chores

• bump license year (#74) (769175d)

Documentation

• add some missing javadocs (#78) (d153ef9)

Refactors

• client: switch query params objects to use QueryParams (#64) (4e9c3eb)
• internal: use constructor to deserialize json (#66) (27389cd)

0.8.1 (2024-12-21)

Full Changelog: v0.8.0...v0.8.1

Chores

• docs: add example project (#59) (045c7ba)
• docs: fix code block language (#61) (4301693)
• docs: update readme (#58) (ef3dcd5)
• format example (892bb69)
• internal: spec update (#55) (768138f)
• update parameter examples in tests and docs (#57) (afe3e0e)

Documentation

• add note about feedback (1a5517f)

0.8.0 (2024-12-17)

Full Changelog: v0.7.5...v0.8.0

Features

• api: new o1 and GPT-4o models + preference fine-tuning (#46) (4f2fac5)

Chores

• internal: spec update (#48) (777165c)

0.7.5 (2024-12-13)

Full Changelog: v0.7.4...v0.7.5

Chores

• internal: remove unused and expand used wildcard imports (#43) (39bfc4e)
• internal: remove unused and expand used wildcard imports (#44) (7f7e131)
• test: use JsonValue instead of JsonString (#41) (8d2dd03)

0.7.4 (2024-12-12)

Full Changelog: v0.7.3...v0.7.4

Chores

• test: remove unused imports (#39) (1ce3035)

0.7.3 (2024-12-11)

Full Changelog: v0.7.2...v0.7.3

Chores

• internal: remove unused imports (#38) (021177f)

Styles

• internal: make enum value definitions less verbose (#35) (1effd49)
• internal: move enum identity methods to bottom of class (#37) (7a9d27a)

0.7.2 (2024-12-11)

Full Changelog: v0.7.1...v0.7.2

Chores

• update example values in tests and docs (#33) (e74f2b5)

0.7.1 (2024-12-09)

Full Changelog: v0.7.0...v0.7.1

Chores

• internal: configure sonatype (#30) (5d7816a)

0.7.0 (2024-12-04)

Full Changelog: v0.6.0...v0.7.0

Features

• api: updates (#29) (a3122af)

Chores

• bump openapi url (#28) (24d8461)

Documentation

• add missing parameter to code snippet (#26) (8e7421f)

0.6.0 (2024-11-27)

Full Changelog: v0.5.1...v0.6.0

⚠ BREAKING CHANGES

• client: remove duplicated classes

Features

• derive gpg release key's id via gpg itself (#25) (6aad041)

Bug Fixes

• client: remove duplicated classes (8a8f11f)

0.5.1 (2024-11-26)

Full Changelog: v0.5.0...v0.5.1

Chores

• internal: update example values (#21) (2270e67)

0.5.0 (2024-11-25)

Full Changelog: v0.4.0...v0.5.0

Features

• client: add logging when debug env is set (#18) (017aae7)

Documentation

• add note that we're in alpha (#19) (d49cc28)
• readme: add Microsoft Azure section (#17) (8f8165f)
• swap example from .completions() to .chat().completions() (#20) (f0423a7)

Styles

• internal: reorder some params methods and improve consistency of implementations (#15) (8592cda)

0.4.0 (2024-11-21)

Full Changelog: v0.3.0...v0.4.0

Features

• azure: Add HttpRequest.Builder extension methods (#9) (097c7c9)

Bug Fixes

• azure: add missing azure changes (656d3b5)

0.3.0 (2024-11-20)

Full Changelog: v0.2.0...v0.3.0

Features

• api: add gpt-4o-2024-11-20 model (#13) (3263126)

Styles

• internal: move identity methods to bottom of error class (#12) (f3ff42a)
• internal: reduce verbosity of identity methods (#10) (9ef03ed)

0.2.0 (2024-11-20)

Full Changelog: v0.1.0...v0.2.0

Features

• client: add async streaming methods (#6) (f805972)
• initial commit (fa016ee)

Performance Improvements

• tests: remove unused dependencies (#3) (4c94984)

Chores

• deps: bump jackson to 2.18.1 (#7) (9262ca7)
• internal: spec update (#5) (0df36a4)

Documentation

• bump models in example snippets to gpt-4o (#4) (359c100)

0.1.0 (2024-11-08)

Full Changelog: v0.0.1...v0.1.0

⚠ BREAKING CHANGES

• client: simplify structure of strings with presets
• client: replace multimaps with custom types
• client: add/rename methods for headers/query params
• client: rename header and query params builder methods
• client: union and builder method naming conflicts
• client: don't generate default variant field/method names with underscores

Features

• add example (ff05dec)
• add SSE and many other major updates (6eb3f62)
• api: add chatgpt-4o-latest model (f0d7c9a)
• api: add file search result details to run steps (9ec089e)
• api: add gpt-4o-audio-preview model for chat completions (e81ac84)
• api: add new gpt-4o-mini models (a5a855e)
• api: add new, expressive voices for Realtime and Audio in Chat Completions (c4d5fbd)
• api: add o1 models (b9db26a)
• api: add omni-moderation model (5935c8c)
• api: add support for predicted outputs (a72d1ea)
• api: add uploads endpoints (9963139)
• api: support storing chat completions, enabling evals and model distillation in the dashboard (670e73f)
• api: updates (c818fda)
• client: add Headers class (339e93c)
• client: add Headers class (02b56b3)
• client: add QueryParams class (bf7b4a2)
• client: add User-Agent header (5bab5cc)
• client: add more endpoints (48a86ca)
• client: add streaming (e8fc6aa)
• client: add/rename methods for headers/query params (80ca5d9)
• client: added structured fields to errors (ffc1d7a)
• client: clean up resource leaks when the resource becomes phantom reachable (3ab123c)
• client: improve binary return values (40e6b7c)
• client: more additional body param setters (07262da)
• client: propagate headers/query params methods to client builders (ed455e3)
• client: replace multimaps with custom types (c92580f)
• client: send retry count header (8058647)
• client: set X-Stainless-Runtime header (1576020)
• client: simplify structure of strings with presets (c6f3499)
• client: support error property (aef3473)
• client: support union discriminators in deserialization (fd0e4bd)
• extract out ImageModel, AudioModel, SpeechModel (7c23848)
• make enums not nominal (dce0b9e)
• updates (4fbb12b)
• updates (303b5f2)
• updates (#4) (af9f9a2)
• vector store: improve chunking strategy type names (1e5d0cd)

Bug Fixes

• audio: correct response_format translations type (f84b960)
• client: accidental double-wrapping with RetryingHttpClient (c96911b)
• client: add @JvmOverloads to HttpClient methods (95344ef)
• client: correct types for transcriptions / translations (5207123)
• client: disallow reusing stream response (6eb1979)
• client: don't generate default variant field/method names with underscores (c49334f)
• client: ensure constructed objects are immutable (ef4d884)
• client: ensure SSE BufferedReader gets closed (685553f)
• client: error class toBuilder not copying fields (92b5889)
• client: escape keywords reserved in java, but not in kotlin, for the java sdk (12e0cc6)
• client: implement hashCode for IsMissing (b841254)
• client: naming of some variants (3a764f2)
• client: naming of some variants (881affb)
• client: union and builder method naming conflicts (3566be1)
• docs: use correct putAdditionalProperty value (babeb82)
• example for preset simplification (#150) (1c63b4b)
• improve schema definitions (6beee8a)
• internal: remove unnecessary error handler in client (fe5be51)
• internal: remove unnecessary error handlers (205ee00)
• remove additionalBodyProperties from methods that don't support request bodies (df81636)

Chores

• ci: bump prism mock server version (16fcad2)
• ci: codeowners file (0e29d12)
• ci: run tests in CI (7a8cd60)
• docs: fix maxium typo (c6258a2)
• internal: delete unused function (54eb041)
• internal: omit unnecessary code (e87d4ec)
• internal: remove unnecessary .buffered() call (2e43707)
• internal: remove unnecessary [@file](https://github.com/file):Suppress("OVERLOADS_INTERFACE") (0c219ed)
• internal: remove unnecessary [@file](https://github.com/file):Suppress("OVERLOADS_INTERFACE") (fbf13e1)
• internal: remove unnecessary [@file](https://github.com/file):Suppress("OVERLOADS_INTERFACE") (b8ab775)
• internal: remove unused test file (24d08bb)
• internal: remove useless [@file](https://github.com/file):JvmSynthetic (046092d)
• internal: update spec link (a3b99f8)
• internal: update spec url (6d8a32d)
• sync openapi url (1868ddd)
• tests: add tests for services (c58ba71)
• tests: update prism version (f7cb198)
• types: define FilePurpose enum (e2c15b1)
• unknown commit message (6eb1979)
• unknown commit message (c6f3499)
• unknown commit message (92b5889)
• unknown commit message (07262da)
• unknown commit message (c92580f)
• unknown commit message (c6089f1)
• unknown commit message (a72d1ea)
• unknown commit message (80ca5d9)
• unknown commit message (4fd6c23)
• unknown commit message (ed455e3)
• unknown commit message (bf7b4a2)
• unknown commit message (02b56b3)
• unknown commit message (93141d4)
• unknown commit message (ef4d884)
• unknown commit message (505c349)
• unknown commit message (54eb041)
• unknown commit message (44ab47a)
• unknown commit message (c4d5fbd)
• unknown commit message (3ab123c)
• unknown commit message (685553f)
• unknown commit message (d86694a)
• unknown commit message (2e43707)
• unknown commit message (c96911b)
• unknown commit message (5bab5cc)
• unknown commit message (1576020)
• unknown commit message (48a86ca)
• unknown commit message (b841254)
• unknown commit message (aef3473)
• unknown commit message (734939c)
• unknown commit message (95344ef)
• unknown commit message (0c219ed)
• unknown commit message (046092d)
• unknown commit message (f0bc243)
• unknown commit message (86e3988)
• unknown commit message (b8ab775)
• unknown commit message (2d98a2c)
• unknown commit message (c58ba71)
• unknown commit message (881affb)
• unknown commit message (0b8b5a8)
• unknown commit message (a804776)
• unknown commit message (e8fc6aa)
• unknown commit message (fd0e4bd)
• unknown commit message (3566be1)
• unknown commit message (fe5be51)
• unknown commit message (205ee00)
• unknown commit message (e87d4ec)
• unknown commit message (b8509fb)
• unknown commit message (f8eceaa)
• unknown commit message (3989402)
• unknown commit message (c49334f)
• unknown commit message (c6e40de)
• unknown commit message (12e0cc6)
• unknown commit message (9ec34a8)
• unknown commit message (670e73f)
• unknown commit message (5207123)
• unknown commit message (8058647)
• unknown commit message (6d8a32d)
• unknown commit message (b9db26a)
• unknown commit message (ffc1d7a)
• unknown commit message (5d05171)
• unknown commit message (1e5d0cd)
• unknown commit message (b72a723)
• unknown commit message (df81636)
• unknown commit message (babeb82)
• unknown commit message (e2c15b1)
• unknown commit message (1868ddd)
• unknown commit message (16fcad2)
• unknown commit message (0e29d12)
• unknown commit message (c818fda)
• unknown commit message (dce0b9e)
• unknown commit message (7c23848)
• unknown commit message (7a8cd60)
• unknown commit message (40e6b7c)
• unknown commit message (24d08bb)
• unknown commit message (f7cb198)
• unknown commit message (a5a855e)
• unknown commit message (303b5f2)
• update repo name (11c62f2)
• use headless jdk for containers (b72a723)

Documentation

• adjust additional properties example (5d05171)

Styles

• client: disable formatting for java boilerplate (c6e40de)
• client: make toString methods consistent (0b8b5a8)
• client: move equals, hashCode, and toString to the bottom of entity files (9ec34a8)
• internal: improve OkHttpClient formatting (70f673c)
• internal: improve OkHttpClient formatting (86e3988)
• internal: improve RetryingHttpClient formatting (734939c)
• internal: improve terseness of handlers (3989402)
• internal: improve terseness of Properties.kt (f8eceaa)
• internal: make getOrThrow terse and consistent (44ab47a)
• internal: move Handlers.kt and HttpRequestBodies.kt to core (b8509fb)
• internal: rename streamingResponse to streamResponse (d86694a)
• internal: simplify client build method (f0bc243)
• internal: update comment formatting (2d98a2c)
• internal: use if and if-else instead of when idiomatically (a804776)

Refactors

• client: http request methods (c6089f1)
• client: rename header and query params builder methods (4fd6c23)
• internal: inline MoreExecutors usage (505c349)
• internal: polish ClientOptions (13c9038)
• internal: polish ClientOptions (93141d4)