NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Maven Central, #834 by repository stars
swagger-models
Latest stable
3.0.0
Last release 19 days ago
29 Oct 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
84 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
Bump Jetty version (test) - address CVE-2021-28169
refs #3060 #3935 - build time / ext app applicationPath resolving
refs #3926 - extended repeatable annotations support
Your coding agent can read these notes before it upgrades. Set up the MCP server →
JsonTypeInfo.As.WRAPPER_OBJECT support (#2884, #2862) (#3921)refs CVE-2020-8908 - bump test dep guava
NOTE: First release with Jakarta namespace support. See wiki, maven readme and gradle readme.
swagger-jaxrs2:2.1.6 in OSGi due to transitive depen… (#3839)automation - replace deprecated set-env in workflows
refs #3711 - expose ctxId resolving in BaseOpenApiResource
refs #2845 - resolve @JsonIgnoreProperties as property annotation (partial support)
refs #3500 - fix @Deprecated processing
refs #3412 - deprecate swagger-jaxrs2-servlet-initializer add alternative with different package
swagger-jaxrs2-servlet-initializer add alternative with different package (#3481)NOTE swagger-jaxrs2-servlet-initializer artifact is DEPRECATED since 2.1.2 (please see #3412 and #3481), please use instead swagger-jaxrs2-servlet-initializer-v2 (same class io.swagger.v3.jaxrs2.integration.SwaggerServletInitializer)
refs #3409 - fix jsonValue processing (#3483)
refs #3259 - fix required annotation processing for reference properties (#3482)
refs #3438 - fix arraySchema required (#3478)
refs #3443 - Resolve java.time.Instant as date-time instead of long (#3477)
refs #3464 - change scope of hiddingByJsonView to protected (#3474)
refs #3111 - fix Schema.implementation processing for primitive types (#3468)
Refs #3399, #3445 Change javax to jakarta artifact dependencies, relax OSGI import (#3467)
Classgraph 4.8.65 (#3458)
update maven central URLs (#3435)
Fix typo in AnnotationsUtils; Fixes #3423 (#3424)
refs #3414 - fix enumsAsRef global property behavior (#3417)
refs #3345 - Include discriminator mapped schemas when filtering
refs #3348 - clone all resolved properties
Enable caching of Gradle 'ResolveTask' - remove compatibility to Gradle versions prior to 3.2
Note: swagger-gradle-plugin version for this release is 2.0.9.1, this is due to an issue with the publishing mechanism of gradle plugin portal
Note: swagger-gradle-plugin version for this release is 2.0.9.1, this is due to an issue with the publishing mechanism of gradle plugin portal
deserialize into MapSchema for bool additionalProperties
fix #3088 - fixes boolean @type annotation
ref #3029 - fix ref parameter resolving
implements maven and gradle plugins
make ModelResolver _isOptionalType protected
…This is a breaking change, but it makes sense as the previous datatype was basically wrong and meaningless. An alternative would be deprecating reques…
Add ref field to annotations with related support in Reader (#2839)
refs #2848 - fix required resolving for arrayschema schema (#2867)
refs #2778 - also consider NotEmpty and NotBlank to resolve required (#2876)
refs #2833 - fixes and resolves Links requestBody (#2877)
IMPORTANT NOTE: this PR addresses #2833, by updating requestBody member datatype of swagger-models Link to be Object instead of previous RequestBody, as it correctly maps to OpenAPI definition https://github.com/OAI/OpenAPI-Specification/blob/3.0.1/versions/3.0.1.md#linkObject.
This is a breaking change, but it makes sense as the previous datatype was basically wrong and meaningless. An alternative would be deprecating requestBody, and introducing a new requestBodyObject serialized as JSON requestBody via mixin and jackson annotations.
NPE on Json sub type with no name defined (#2862)
Add ref field to annotations with related support in Reader (#2839)
supports primitives in oneOf, anyOf, allOf schema annotations (#2902)
Updates master branch to Swagger 2.0 / OpenAPI 3.0 code; 1.5.X code has been moved from master to 1.5 branch where 1.5.X code development/maintenance
Notable features
Updates master branch to Swagger 2.0 / OpenAPI 3.0 code; 1.5.X code has been moved from master to 1.5 branch where 1.5.X code development/maintenance will continue (#2787)
Allows custom typename resolving (#2121)
Matrix param support (#2799)
@NotNull support in parameter (#2803)
Avoid NPE in some scenarios involving maps (#2793)
Full support for ArraySchema properties via annotations (#2806)
Fix CVE-2018-7489 - jackson version 2.9.5
Notable features
Mainly bug fix release implementing/fixing the following:
JDK 9/10 support in build (#2735)
Supports OpenAPIExtension decorateOperation (#2748)
Fix path building for resources without leading slashes (#2751)
Fix stackOverflowError for circuclar reference in jackson ModelResolver (#2740)
Fix CVE-2018-7489 - jackson version 2.9.5 (#2755)
Fix random build error (#2752)
Fix NPE in Reader with null config (#2736)
Improve support for #2635
Correctly resolve array schema annotations with ref schema items (#2763)
Fix security scheme name/key resolving (#2767)
deprecates Schema.readOnly and introduces accessMode field
The Swagger team is proud to announce the first official 2.0.0 release of our main java library swagger-core. This release enhances rc4 support for OpenAPI 3.0’s main features.
In order to better improve these libraries and tools, we ask that you start using them and provide us with feedback in form of issues (please use label 3.0 spec support) on the github repository. The issues are a huge help in finding what’s missing or not working properly (though note some issues are already submitted). We would also appreciate any PRs that improve existing or new tickets.
Be aware that the release notes contain the notable changes, but there may some changes that we missed in the list.
openapi.json and openapi.yaml to known locations (#2727)The Swagger team is proud to announce the rc4 release candidate of our main java library swagger-core. This release candidate enhances rc3 support for
The Swagger team is proud to announce the rc4 release candidate of our main java library swagger-core. This release candidate enhances rc3 support for OpenAPI 3.0’s main features. The missing features will be added in the final release.
In order to better improve these libraries and tools, we ask that you start using them and provide us with feedback in form of issues (please use label 3.0 spec support) on the github repository. The issues are a huge help in finding what’s missing or not working properly (though note some issues are already submitted). We would also appreciate any PRs that improve existing or new tickets.
Be aware that the release notes contain the notable changes, but there may some changes that we missed in the list. The same applies for the Limitations section.
Boolean or Schema (#2461)RequestBody and other annotations support (#2562)MatrixParam annotation supportProject `groupId` and package naming have changed since `v2.0.0-rc3` (see ticket #2485) New groupId is `io.swagger.core.v3`, therefore e.g. `swagger-j
Project groupId and package naming have changed since v2.0.0-rc3 (see ticket #2485)
New groupId is io.swagger.core.v3, therefore e.g. swagger-jaxrs2 maven dependency is in the form:
<dependency>
<groupId>io.swagger.core.v3</groupId>
<artifactId>swagger-jaxrs2</artifactId>
<version>2.0.0-rc3</version>
</dependency>
Root package for all modules also changed to io.swagger.v3, e.g. swagger-jaxrs2 root package is now io.swagger.v3.jaxrs2
The Swagger team is proud to announce the rc3 release candidate of our main java library swagger-core. This release candidate enhances rc2 support for OpenAPI 3.0’s main features. The missing features will be added in the final release.
In order to better improve these libraries and tools, we ask that you start using them and provide us with feedback in form of issues (please use label 3.0 spec support) on the github repository. The issues are a huge help in finding what’s missing or not working properly (though note some issues are already submitted). We would also appreciate any PRs that improve existing or new tickets.
Be aware that the release notes contain the notable changes, but there may some changes that we missed in the list. The same applies for the Limitations section.
groupId and package naming change! (#2485, see also above)ServletContainerInitializer based startup scanning (#2504, see related samples in samples, jersey sample, RESTEasy sample)@OpenAPIDefinition support (#2517)@ApplicationPath support (#2489)@Schema elements resolving (#2476)@Hidden support (#2528)@Schema.subTypes support (#2511)@ArraySchema support (#2501)MatrixParam annotation supportOne column per quarter.