OpenAPI Generator Files

v7.24.0 stable release (breaking changes with fallbacks) comes with 170+ enhancements and bug fixes.

Below are the highlights of the changes. For a full list of changes, please refer to the "Pull Request" tab.

General

• fix(docker): update base image to eclipse-temurin 17.0.19 on Ubuntu 24.04 (noble) [#24230]
• fix(InlineModelResolver): do not merge untitled inline schemas differing only by description [#24192]
• Fix vulnerable dependency CVE-2026-54512 [#24166]
• [core] Add introspection support for discovering the discriminator type in a oneOf allOf polymorphic structure [#24158]
• refactor: introduce DiscriminatorUtils to separate handling of discriminator discoverability [#24143]
• fix: normalize OAS 3.1 schemas with type:[object,"null"] to set nullable:true correctly [#24140]
• feat(spec-merge): add alternative DEEP merge mode with by-method path merging and configurable conflict resolution strategy [#24100]
• [core] Restore sibling example for allOf with a single $ref (#23335) [#24081]
• [core] Fix UnsupportedOperationException for oneOf members declaring x-implements (#23577) [#24076]
• [CORE] - Feature: forcedGenerateSchemas — Force generation of schema-mapped or import-mapped schemas [#24066]
• [Core] bug - fix OAS 3.1 nullable validation when using older "nullable: true" syntax instead of type: [null, ...] [#24026]
• fix(online): thread-safe fileMap with TTL cleanup, SLF4J logging, and Content-Length header [#24011]
• [BUG][core] Normalize OAS 3.1 type: null map value (additionalProperties) under NORMALIZE_31SPEC [#23967]
• Add validate Mojo to Maven Plugin [#23911]
• feat: add quiet mode to suppress verbose generation output [#23831]

asciidoc

• fix(asciidoc): escape table cell pipes in generated docs [#24184]

avro

• fix(avro): order "null" first in union when default is null [#24135]

C++

• fix(cpp-httplib-server): serialize enums using spec values [#24187]
• C++ Boost.Beast client generator with OpenAPI 3.1 support [#24335]

C

• fix(aspnetcore): remove obsolete wwwroot README [#24283]
• [csharp][generichost] Refactor duplicate apis [#24273]
• [csharp][generichost] Revert to DropWrite [#24080]
• [csharp][generichost] Add OnCreated to JsonConverter [#24079]

Crystal

• [Crystal] Add request-signing seam (Configuration#sign_request) [#24221]
• [Crystal] idiomatic api redesign [#24070]

Dart

• Dart2 class and enum improvements [#24286]
• [dart-dio][built_value] Register BuilderFactory for nested additionalProperties shapes [#24154]
• [dart-dio][built_value] Honor optional non-nullable properties in deserialize_properties.mustache [#23661]
• [dart-dio] Fix webhook imports generating Map-style strings [#22611]

Go

• fix(golang): make object values nullable when specified [#24265]
• fix(go-server): allow zero values for required request body fields [#24262]
• fix(go-server): skip readOnly fields in AssertXxxRequired [#24257]
• fix(go-server): use operationId consistently to fix uncompilable output for duplicate operationIds [#24169]
• [Go] Honor generateUnmarshalJSON=false for oneOf models [#24062]

Java

• [Java][apache-httpclient] Apply connect timeout to requests, add read timeout support [#24284]
• [java][microprofile] Extend useSealedOneOfInterfaces support to the microprofile library [#24267]
• [java][microprofile] Extend support for useOneOfInterfaces to the microprofile library when Jackson serialisation is enabled [#24190]
• [java][jaxrs-spec] - Add support for sealed classes and interfaces with useSealed flag [#24189]
• [KOTLIN-SPRING;JAVA-SPRING] bugfix: update JsonInclude annotations for optional+nullable fields to handle serialization correctly when openApiNullable = true [#24185]
• [java][jaxrs-spec][quarkus] - Add support for OneOfInterfaces & fix JsonTypeName value resolution [#24174]
• Convert maintained JAX-RS samples to JUnit 5 [#24173]
• fix: normalize Java annotation vendor extension lists [#24171]
• [jaxrs-spec] Add @JsonIgnoreProperties on the discriminator to avoid duplicated keys during serialisation [#24132]
• [java] honor useJspecify in restclient/webclient ApiClient support class [#24055]
• [Java][vertx] Apply Vert.x pool defaults in buildWebClient for useVertx5 [#24017]
• [Java] Render object default for composed ($ref + default) schemas (#23795) [#23971]

Julia

• [julia-server] Use req.headers for HTTP.jl 2.x compatibility [#24102]

Kotlin

• [KOTLIN-SPRING;JAVA-SPRING] bugfix: update JsonInclude annotations for optional+nullable fields to handle serialization correctly when openApiNullable = true [#24185]
• [Kotlin][Spring] fix option useSpringBuiltInValidation not implemented [#24115]
• [KOTLIN-SPRING/KOTLIN-CLIENT] BUG - fix json deserialization when kotlin attribute name differs from json attribute name [#24036]
• [kotlin] Fix boolean const enum literal generation [#24022]
• [kotlin-spring, java-spring] - gate @JsonSetter on openApiNullable for optional non-nullable fields [#23993]

openapi, openapi-yaml

• [openapi, openapi-yaml] feature - add sortOutput option to deterministically sort paths and schemas, http methods, etc... [#24037]

PHP

• [PHP] Skip length validation for DateTime model properties [#24254]
• Update php-laravel to newer versions [#24196]
• [php-nextgen] Fix undefined variable $queryParams [#24136]
• [php-nextgen] Code improvements [#23986]
• [php-nextgen] oneof polymorphism [#23985]
• [php-nextgen] Fix for enum allowed values [#23814]

Python

• [python] support legacy model dictionaries [#24290]
• fix(python-fastapi): map binary response type file to bytes [#24285]
• [python] bump generated client dependency floors above vulnerable ranges [#24186]
• feat(python-flask): add opt-in Connexion 3 support [#24181]
• [python] Set API key cookie as key-value pair [#24149]
• [python] centralize the Python constraint rules [#24141]
• [python] preserve public model field names [#24131]
• [python] isolate implicit API clients [#24129]
• [python] add supportHttpxSync option for sync httpx methods [#24128]
• [python] separate property and parameter mappings [#24121]
• [python] escape model wire names [#24120]
• [python] serialize structured YAML bodies [#24084]
• [python] honor proxy environment settings [#24082]
• [python] Run regex pattern validators in mode="before" so they see the wire value [#24072]
• fix(python): remove redundant debug setter call in deepcopy [#23958]
• [python][client] Add Decimal support to mapNumberTo functionality [#23916]
• fix(python-flask): validate byte length for format:byte fields [#23177]

Ruby

• [Ruby] Add new ruby-nextgen client generator (opt-in idiomatic redesign) [#24220]
• fix(ruby): JSON-encode query params with content:application/json [#24126]

Rust

• fix(rust-server): Handle multiple content-types in responses [#24179]
• [rust-server] Fix panic on binary request bodies coerced to UTF-8 [#24116]
• [Rust-Axum] Fix generating error upon special model name [#23994]
• [Rust-Axum] Support Server-Sent Events (SSE) [#23977]

Scala

• [scala-sttp4-jsoniter] support set parameters (uniqueItems arrays) in query, header, path and cookie parameters [#24301]

TypeScript

• fix(typescript-fetch): allow null for required nullable parameters [#24292]
• [typescript-fetch] Fix Omit generic using baseName for readOnly fields [#24275]
• typescript-fetch: default to es6 support [#24226]
• fix(typescript-fetch): skip scalar enum comparison for array-typed properties in instanceOf [#24217]
• fix(typescript-fetch): add anyToJSON to runtime.ts [#24216]
• fix(typescript-fetch): optional nullable fields return null instead of undefined [#24215]
• [typescript] Align multipart file array handling [#24133]
• fix(typescript-nestjs-server): import generic return types [#24005]
• [typescript-fetch] Fix TS2590 in instanceOf guards for wide sanitized-name models [#23982]