domaindrivendev/Swashbuckle.AspNetCore

View on GitHub

Swagger tools for documenting API's built on ASP.NET Core

Stars: 5.5k
Forks: 1.3k
Open beginner issues: 0
Indexed issues: 161
Avg merge: 1d 12h
Merged PRs (30d): 31

Dominant language: C#
License: MIT
Last GitHub push: Sep 14, 2026
Latest indexed: Sep 15, 2026
Contributing guide: Contributing guide
Code of conduct: No code of conduct
Beginner labels: help wanted good first issue

Open All

160 open issues indexed

Type mapping conventions Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#448 · 0 comments · 4 reactions · 0 assignees · Indexed Sep 15, 2026
Support C#7 value tuples Open

help-wanted p2

domaindrivendev/Swashbuckle.AspNetCore#501 · 5 comments · 6 reactions · 0 assignees · Indexed Sep 15, 2026
Emit x-ms-error-response on error response types Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#744 · 3 comments · 1 reaction · 0 assignees · Indexed Sep 15, 2026
Support multi-tenant use case for SwaggerGenOptions Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#753 · 0 comments · 10 reactions · 0 assignees · Indexed Sep 15, 2026
feat: ResponseFilter Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#848 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Implicitly use output of project when running dotnet swagger Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#881 · 3 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Support for describing common parameters Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#934 · 1 comment · 1 reaction · 0 assignees · Indexed Sep 15, 2026
Swashbuckle is Naked! It needs a pretty Icon (for nuget, banner, etc) Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#969 · 0 comments · 2 reactions · 0 assignees · Indexed Sep 15, 2026
Callbacks/webhooks support Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#976 · 18 comments · 39 reactions · 0 assignees · Indexed Sep 15, 2026
OAuthConfigObject is missing a ton of stuff that OAS3 wants. Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#1028 · 2 comments · 5 reactions · 0 assignees · Indexed Sep 15, 2026
Improve out-of-the-box support for XML API's Open

help-wanted p1

domaindrivendev/Swashbuckle.AspNetCore#1050 · 6 comments · 3 reactions · 0 assignees · Indexed Sep 15, 2026
Support for collectionFormat values besides _multi_ Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#1072 · 3 comments · 1 reaction · 0 assignees · Indexed Sep 15, 2026
Swagger ignores route parameter constraint Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#1096 · 4 comments · 6 reactions · 0 assignees · Indexed Sep 15, 2026
[FromForm] and lists are not serialized correctly? Open

help-wanted

domaindrivendev/Swashbuckle.AspNetCore#1107 · 20 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Is it possible to generate swagger for all available versions using swashbuckle.aspnetcore.cli Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#1126 · 11 comments · 15 reactions · 0 assignees · Indexed Sep 15, 2026
Feature request - Custom/Global API Response Attributes Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#1223 · 2 comments · 1 reaction · 0 assignees · Indexed Sep 15, 2026
Feature Request: Logging for generation Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#1247 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Support root-relative paths in endpoint paths in Swagger UI Open

help-wanted

domaindrivendev/Swashbuckle.AspNetCore#1253 · 27 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Add msbuild extension Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#1313 · 3 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Fails for class derived from DynamicObject (not what you think) Open

help-wanted p2

domaindrivendev/Swashbuckle.AspNetCore#1314 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
[Feature Request] OpenAPI links Open

help-wanted p2

domaindrivendev/Swashbuckle.AspNetCore#1324 · 5 comments · 20 reactions · 0 assignees · Indexed Sep 15, 2026
Empty response tag in summary generates empty entry in response dictionary Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#1380 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
System.OverflowException when processing enums Open

help-wanted p2

domaindrivendev/Swashbuckle.AspNetCore#1435 · 4 comments · 3 reactions · 0 assignees · Indexed Sep 15, 2026
[v5.0.0] JsonProperty Required.Always value not respected from ContractResolver when generating schema Open

help-wanted p1

domaindrivendev/Swashbuckle.AspNetCore#1486 · 1 comment · 3 reactions · 0 assignees · Indexed Sep 15, 2026
string enum values are sorted randomly Open

help-wanted p2

domaindrivendev/Swashbuckle.AspNetCore#1541 · 1 comment · 7 reactions · 0 assignees · Indexed Sep 15, 2026
Add support for "genericModelSubstitutes" Open

help-wanted p2

domaindrivendev/Swashbuckle.AspNetCore#1659 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 15, 2026
ISchemaFilter doesn't traverse recursive fields/properties Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#1668 · 0 comments · 2 reactions · 0 assignees · Indexed Sep 15, 2026
SwaggerParameterAttribute missing properties Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#1778 · 3 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
OpenApiDocument.Info parameter in IDocumentFilter is not reset on applying the filter Open

help-wanted p2

domaindrivendev/Swashbuckle.AspNetCore#1923 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
XML comment for property referencing schema displays schema summary Open

help-wanted p1

domaindrivendev/Swashbuckle.AspNetCore#1939 · 5 comments · 2 reactions · 0 assignees · Indexed Sep 15, 2026
Support additional attributes from System.ComponentModel namespace Open

help-wanted p2

domaindrivendev/Swashbuckle.AspNetCore#1954 · 3 comments · 5 reactions · 0 assignees · Indexed Sep 15, 2026
CLI and Web endpoint produce different swagger.json outputs when routing convention is configured through an IApplicationModelConvention is delayed Open

help-wanted p2

domaindrivendev/Swashbuckle.AspNetCore#1957 · 8 comments · 2 reactions · 0 assignees · Indexed Sep 15, 2026
`OrderActionsBy` should take `IComparer<ApiDescription>` or second argument `IComparer<string>` Open

help-wanted p2

domaindrivendev/Swashbuckle.AspNetCore#2001 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
How to define base url in swashbuckle 5.0 within asp.net core 3.1 Open

help-wanted

domaindrivendev/Swashbuckle.AspNetCore#2004 · 25 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Changes to OpenApiInfo via DocumentFilter persist between Swagger generations Open

help-wanted p2

domaindrivendev/Swashbuckle.AspNetCore#2021 · 2 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Fully support STJ's converters Open

help-wanted p3

domaindrivendev/Swashbuckle.AspNetCore#2050 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 15, 2026
SwaggerDiscriminator Attribute: discriminator field moved from paths to components Open

help-wanted

domaindrivendev/Swashbuckle.AspNetCore#2052 · 19 comments · 12 reactions · 0 assignees · Indexed Sep 15, 2026
Ability to use cref property from xml comments to override which schema for parameters Open

help-wanted

domaindrivendev/Swashbuckle.AspNetCore#2066 · 0 comments · 1 reaction · 0 assignees · Indexed Sep 15, 2026
Ampersand in XML-<example>-Value not rendered correctly Open

help-wanted

domaindrivendev/Swashbuckle.AspNetCore#2071 · 1 comment · 1 reaction · 0 assignees · Indexed Sep 15, 2026
Allow CORS on swagger.json endpoint only Open

help-wanted p2

domaindrivendev/Swashbuckle.AspNetCore#2078 · 3 comments · 1 reaction · 0 assignees · Indexed Sep 15, 2026
Error generating schema containing TimeSpans when UseAllOfForInheritance option is enabled Open

help-wanted p2

domaindrivendev/Swashbuckle.AspNetCore#2090 · 5 comments · 10 reactions · 0 assignees · Indexed Sep 15, 2026
Update default recommendation on page to suggest PKCE approach to docs instead of Implict Open

help-wanted

domaindrivendev/Swashbuckle.AspNetCore#2095 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Support adding sample values for objects using <example> xml tag Open

help-wanted

domaindrivendev/Swashbuckle.AspNetCore#2096 · 1 comment · 6 reactions · 0 assignees · Indexed Sep 15, 2026
6.1.3 IsNonNullableReferenceType returns incorrect value when class contains EFCore Navigation property Open

help-wanted

domaindrivendev/Swashbuckle.AspNetCore#2109 · 10 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Add Example to Swashbuckle.AspNetCore.Annotations Open

help-wanted

domaindrivendev/Swashbuckle.AspNetCore#2115 · 2 comments · 1 reaction · 0 assignees · Indexed Sep 15, 2026
Range max value only sometimes hidden Open

help-wanted

domaindrivendev/Swashbuckle.AspNetCore#2135 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Please add support for System.Text.Json's JsonConstructorAttribute. Open

help-wanted

domaindrivendev/Swashbuckle.AspNetCore#2148 · 0 comments · 2 reactions · 0 assignees · Indexed Sep 15, 2026
$ref siblings Open

help-wanted

domaindrivendev/Swashbuckle.AspNetCore#2158 · 3 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Conflict between includeControllerXmlComments and TagActionsBy Open

help-wanted

domaindrivendev/Swashbuckle.AspNetCore#2160 · 0 comments · 1 reaction · 0 assignees · Indexed Sep 15, 2026
Feature request: output multiple swagger versions in the CLI Open

help-wanted

domaindrivendev/Swashbuckle.AspNetCore#2169 · 2 comments · 2 reactions · 0 assignees · Indexed Sep 15, 2026

domaindrivendev/Swashbuckle.AspNetCore

Get new issues in your inbox