swagger-api/swagger-core

View on GitHub

Examples and server integrations for generating the Swagger API Specification, which enables easy access to your REST API

Stars: 7.5k
Forks: 2.3k
Open beginner issues: 0
Indexed issues: 152
Avg merge: 18h 1m
Merged PRs (30d): 10

Dominant language: Java
License: Apache-2.0
Last GitHub push: Sep 2, 2026
Latest indexed: Sep 19, 2026
Contributing guide: Contributing guide
Code of conduct: No code of conduct
Beginner labels: No beginner labels indexed

Beginner friendly Everything

Open All

152 open issues indexed

[Bug]: @Nullable property mutates shared enumAsRef component schema in OpenAPI 3.1 Open

Bug

Difficulty 3/5 1-2 days Newbie friendliness 68/100

swagger-api/swagger-core#5310 · Opened Sep 3, 2026
[Bug]: [swagger-gradle-plugin] ResolveTask execution fails under Gradle 9.7.1+ (Kotlin 2.4.0 internal API accessibility change) Open

backlog Bug

Difficulty 4/5 3-5 days Newbie friendliness 50/100

swagger-api/swagger-core#5308 · Opened Sep 1, 2026
OutOfMemoryError resolving javax.jcr.Node since 2.2.41 — AnnotatedType.isSubtype in equals()/hashCode() splits the resolver cache Open

backlog

Difficulty 4/5 3-5 days Newbie friendliness 48/100

swagger-api/swagger-core#5292 · 1 reaction · Opened Aug 24, 2026
[Bug]: Jackson annotations ignored on enum class (3691) Open

backlog Bug

Difficulty 4/5 3-5 days Newbie friendliness 25/100

swagger-api/swagger-core#5287 · Opened Aug 19, 2026
[Feature]: kotlin support for swagger-maven-plugin-jakarta Open

backlog Feature

Difficulty 4/5 3-5 days Newbie friendliness 45/100

swagger-api/swagger-core#5268 · 1 comment · Opened Aug 13, 2026
[Bug]: JsonSchema fails with JSON round-trip Open

backlog Bug

Difficulty 2/5 1-3 hours Newbie friendliness 74/100

swagger-api/swagger-core#5264 · Opened Aug 11, 2026
[Bug]: incorrect sibling logic when reading type from schema annotation Open

backlog Bug

Difficulty 3/5 1-2 days Newbie friendliness 68/100

swagger-api/swagger-core#5235 · Opened Jul 15, 2026
[Bug]: Explicit @Schema(type = "number"|"integer"|"boolean") is emitted as "string" under OpenAPI 3.1 Open

backlog Bug

Difficulty 3/5 1-2 days Newbie friendliness 72/100

swagger-api/swagger-core#5233 · 7 comments · Opened Jul 15, 2026
[Bug]: duplicate and widening of allowed options Open

backlog Bug

Difficulty 3/5 1-2 days Newbie friendliness 50/100

swagger-api/swagger-core#5198 · 1 comment · Opened Jun 15, 2026
[Question]: Support OAS 3.2 Open

backlog Question

Difficulty 5/5 Over a week Newbie friendliness 25/100

swagger-api/swagger-core#5181 · 5 comments · Opened May 19, 2026
[Feature]: Allow values in @ExampleObject to be read from a file Open

backlog Feature

Difficulty 3/5 1-2 days Newbie friendliness 68/100

swagger-api/swagger-core#5180 · Opened May 13, 2026
Proposal: introduce Schema.NullableMode enum to mirror RequiredMode / AccessMode pattern Open

backlog

Difficulty 5/5 Over a week Newbie friendliness 35/100

swagger-api/swagger-core#5160 · 1 comment · Opened Apr 23, 2026
AnnotationsUtils should not rely on ObjectMapper Open

backlog Feature

Difficulty 3/5 1-2 days Newbie friendliness 55/100

swagger-api/swagger-core#5154 · Opened Apr 17, 2026
[Bug]: Null key for a Map not allowed in JSON Open

backlog Bug

Difficulty 3/5 1-2 days Newbie friendliness 58/100

swagger-api/swagger-core#5126 · 2 reactions · Opened Apr 13, 2026
[Feature]: Prevent name clash for identical nested class names Open

backlog Feature

Difficulty 4/5 3-5 days Newbie friendliness 52/100

swagger-api/swagger-core#5101 · 2 comments · 2 reactions · Opened Mar 27, 2026
📢 Project Maintenance Update & Community Issue Housekeeping Open

announcement backlog

Difficulty 5/5 Over a week Newbie friendliness 15/100

swagger-api/swagger-core#5074 · 3 comments · 16 reactions · Opened Mar 4, 2026
[Feature]: Need since or reason field in @Hidden annotation Open

backlog Feature

Difficulty 2/5 1-3 hours Newbie friendliness 55/100

swagger-api/swagger-core#5045 · 1 comment · Opened Jan 27, 2026
[Bug]: Polymorphic types don't include composite schema reference Open

backlog Bug

Difficulty 4/5 3-5 days Newbie friendliness 35/100

swagger-api/swagger-core#5028 · 3 comments · Opened Dec 15, 2025
"required" property in Schema.java should be a Set (SortedSet for example), not a List Open

backlog BREAKING CHANGE Feature

Difficulty 3/5 1-2 days Newbie friendliness 48/100

swagger-api/swagger-core#5027 · 3 comments · Opened Dec 14, 2025
[Question]: Duplicate schema names don't throw but are overwritten Open

backlog Question

Difficulty 4/5 3-5 days Newbie friendliness 25/100

swagger-api/swagger-core#5016 · 3 comments · 3 reactions · Opened Nov 10, 2025
[Bug]: @ArraysSchema applied on a stream property results in object type in OAS 3.1 Open

backlog Bug

Difficulty 3/5 1-2 days Newbie friendliness 45/100

swagger-api/swagger-core#5013 · Opened Nov 4, 2025
[Feature]: Drop commons-lang3 dependency and replace its usages with core Java Open

backlog Feature

Difficulty 4/5 3-5 days Newbie friendliness 35/100

swagger-api/swagger-core#5011 · 1 comment · Opened Nov 1, 2025
[Bug]: Regression: class specified in @ArraySchema.schema.implementation not rendered in schemas Open

backlog Bug

Difficulty 4/5 3-5 days Newbie friendliness 35/100

swagger-api/swagger-core#4993 · 4 comments · 2 reactions · Opened Oct 11, 2025
[Feature] Support Jackson 3.x release line Open

backlog Feature

Difficulty 5/5 Over a week Newbie friendliness 25/100

swagger-api/swagger-core#4991 · 34 comments · 125 reactions · Opened Oct 10, 2025
[Feature]: Reduce Boilerplate in swagger-core Models (Optional Lombok Support or Alternatives) Open

backlog Feature

Difficulty 5/5 Over a week Newbie friendliness 25/100

swagger-api/swagger-core#4976 · Opened Sep 28, 2025
[Bug]: SpecFilter skips the ApiResponse#$ref field Open

backlog Bug

Difficulty 3/5 1-2 days Newbie friendliness 48/100

swagger-api/swagger-core#4960 · Opened Aug 21, 2025
[Feature]: support for runtime skip properties inside ModelConverter Open

backlog Feature

Difficulty 5/5 Over a week Newbie friendliness 25/100

swagger-api/swagger-core#4951 · Opened Aug 11, 2025
Lack of Friendly Support for Parameter Validation Grouping Open

backlog

Difficulty 5/5 Over a week Newbie friendliness 25/100

swagger-api/swagger-core#4928 · Opened Jul 11, 2025
Ability to remove unused definitions from generated YML Open

backlog

Difficulty 4/5 3-5 days Newbie friendliness 35/100

swagger-api/swagger-core#4924 · Opened Jun 25, 2025
Custom UUID wrapper class can't be used anymore after 2.2.28 Open

backlog

Difficulty 4/5 3-5 days Newbie friendliness 35/100

swagger-api/swagger-core#4923 · Opened Jun 24, 2025
Create an annotation the add at controller level to summarize information regarding failed http responses. Open

backlog

Difficulty 3/5 1-2 days Newbie friendliness 45/100

swagger-api/swagger-core#4910 · 1 comment · Opened Jun 11, 2025
Custom NotNull annotations stopped working between 2.2.28 and 2.2.29 Open

backlog

Difficulty 4/5 3-5 days Newbie friendliness 35/100

swagger-api/swagger-core#4909 · 4 comments · Opened Jun 9, 2025
defaultValue attribute at enum object generate arbitrary json file Open

backlog

Difficulty 3/5 1-2 days Newbie friendliness 35/100

swagger-api/swagger-core#4908 · 1 reaction · Opened Jun 6, 2025
java.lang.Object converted to json object (map) type Open

backlog

Difficulty 4/5 3-5 days Newbie friendliness 30/100

swagger-api/swagger-core#4906 · 1 comment · Opened May 27, 2025
CustomResolver's Results get overwritten by default ModelResolver Open

backlog

Difficulty 4/5 3-5 days Newbie friendliness 35/100

swagger-api/swagger-core#4905 · Opened May 26, 2025
Order of `required` properties Open

backlog

Difficulty 2/5 1-3 hours Newbie friendliness 35/100

swagger-api/swagger-core#4887 · Opened May 13, 2025
2.2.30 - @NotNull(jakarta.validation.constraints.NotNull) assigned to a group should treat field as mandatory Open

backlog

Difficulty 3/5 1-2 days Newbie friendliness 45/100

swagger-api/swagger-core#4877 · 2 comments · 1 reaction · Opened Apr 14, 2025
generate OpenApi yml file with swagger-maven-plugin and with Java 17 #903 Open

backlog

Difficulty 5/5 Over a week Newbie friendliness 20/100

swagger-api/swagger-core#4864 · 2 reactions · Opened Mar 20, 2025
"Override" example value when extending a class Open

backlog

Difficulty 4/5 3-5 days Newbie friendliness 45/100

swagger-api/swagger-core#4863 · 1 reaction · Opened Mar 19, 2025
Bootstrapped servlet returns empty JSON as of 2.2.24 Open

backlog

Difficulty 4/5 3-5 days Newbie friendliness 38/100

swagger-api/swagger-core#4854 · Opened Mar 10, 2025
The example value of the request body in swagger has a "string" value Open

backlog

Difficulty 4/5 3-5 days Newbie friendliness 35/100

swagger-api/swagger-core#4851 · 1 comment · Opened Mar 5, 2025
ModelResolver#resolve ignores TYPE_USE annotations on property types Open

backlog

Difficulty 4/5 3-5 days Newbie friendliness 48/100

swagger-api/swagger-core#4848 · 7 comments · 29 reactions · Opened Feb 26, 2025
@Schema annotation on custom string type is ignored when using @JsonValue Open

backlog

Difficulty 4/5 3-5 days Newbie friendliness 35/100

swagger-api/swagger-core#4847 · Opened Feb 25, 2025
Swagger adds extra line breaks in yaml generated from annotated code Open

backlog

Difficulty 4/5 3-5 days Newbie friendliness 35/100

swagger-api/swagger-core#4846 · Opened Feb 21, 2025
swagger-annotations: Add annotations to support x-enum-descriptions and x-enum-varnames Open

backlog

Difficulty 5/5 Over a week Newbie friendliness 30/100

swagger-api/swagger-core#4844 · 5 reactions · Opened Feb 19, 2025
OpenApi not generated when resourceClasses used Open

backlog

Difficulty 4/5 3-5 days Newbie friendliness 25/100

swagger-api/swagger-core#4843 · Opened Feb 17, 2025
OpenApi doc not beeing generated properly Open

backlog

Difficulty 3/5 1-2 days Newbie friendliness 45/100

swagger-api/swagger-core#4842 · Opened Feb 8, 2025
[Feature] Mark type as deprecated if the class is `@Deprecated` Open

backlog

Difficulty 3/5 1-2 days Newbie friendliness 42/100

swagger-api/swagger-core#4840 · 2 comments · Opened Feb 3, 2025
[Feature/Bug] Forbid mutliple `@ApiResponse` annotations with the same response code Open

backlog

Difficulty 4/5 3-5 days Newbie friendliness 35/100

swagger-api/swagger-core#4839 · 1 comment · Opened Jan 30, 2025
[Open API 3.1] Json31 is incorrectly assuming that property containing `anyOf` is of type: object Open

backlog

Difficulty 3/5 1-2 days Newbie friendliness 42/100

swagger-api/swagger-core#4810 · Opened Dec 13, 2024

swagger-api/swagger-core

Get new issues in your inbox