NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet
NuGet, #593 most downloaded on NuGet
NSwag: The OpenAPI/Swagger API toolchain for .NET and TypeScript
Latest stable
14.7.1
Last release 7 months ago
20 Apr 2026
Release timing varies
gaps range from 2 weeks to 5 months
Most releases are documented
notes for 38 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
369 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
> Upgrade directly from v14.6.3 to v14.7.1 — skip v14.7.0.
[!IMPORTANT] Upgrade directly from v14.6.3 to v14.7.1 — skip v14.7.0.
v14.7.0 bundled NJsonSchema v11.6.0, which contained a regression that silently dropped nullability on
required T?/[JsonRequired] T?DTO properties. The resulting OpenAPI/JSON schema marked those properties as non-nullable, so generated TypeScript and C# clients lost null-safety for fields the server can legitimately return as null (#5359).
v14.7.1 updates to NJsonSchema v11.6.1, which corrects the handling of the C# required keyword and [JsonRequired]:
string?, T?) is preserved.MinLength=1 on non-nullable strings.[Required] semantics remain unchanged (still suppresses nullability and adds MinLength=1 to strings by default, matching its runtime behavior).For public required string[]? OptionList { get; init; } (#5359):
| TypeScript client | C# client | |
|---|---|---|
| v14.7.0 (broken) | optionList: string[] ❌ |
public string[] OptionList ❌ |
| v14.7.1 | optionList: string[] | null ✅ |
public string[]? OptionList ✅ |
For full details and truth tables across all required / [Required] / [JsonRequired] / [JsonProperty(Required=*)] combinations, see the NJsonSchema v11.6.1 release notes and NJsonSchema #1919.
Full Changelog: https://github.com/RicoSuter/NSwag/compare/v14.7.0...v14.7.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →
> Do not use this release — upgrade to [v14.7.1](https://github.com/RicoSuter/NSwag/releases/tag/v14.7.1) or later.
[!CAUTION] Do not use this release — upgrade to v14.7.1 or later.
v14.7.0 bundles NJsonSchema v11.6.0, which contained a regression that silently dropped nullability on
required T?/[JsonRequired] T?DTO properties. Generated TypeScript and C# clients lost null-safety for fields the server can legitimately return as null (#5359). Fixed in v14.7.1.
NSwag.Npm resulting in a NConsole.UnusedArgumentException by @ptasev in https://github.com/RicoSuter/NSwag/pull/5320This release updates to NJsonSchema v11.6.0 and Namotion.Reflection v3.5.0, which include the following changes that may affect generated code:
required keyword now correctly recognized: Properties using the C# 11 required keyword (via RequiredMemberAttribute / JsonRequiredAttribute) are now properly treated as required in the schema and generated code. Previously these were incorrectly treated as optional.WriteAccessor setting to control property setter syntax (set vs init).JsonLibraryVersion setting for controlling enum attribute generation with System.Text.Json.MinLength validation no longer incorrectly applied to DateTime properties.IncludeFields is enabled.For the full list of changes, see the NJsonSchema v11.6.0 release notes.
Full Changelog: https://github.com/RicoSuter/NSwag/compare/v14.6.3...v14.7.0
Caution
Do not use this release — upgrade to v14.7.1 or later.
v14.7.0 bundles NJsonSchema v11.6.0, which contained a regression that silently dropped nullability on required T? / [JsonRequired] T? DTO properties. Generated TypeScript and C# clients lost null-safety for fields the server can legitimately return as null (#5359). Fixed in v14.7.1.
NSwag.Npm resulting in a NConsole.UnusedArgumentException by @ptasev in #5320This release updates to NJsonSchema v11.6.0 and Namotion.Reflection v3.5.0, which include the following changes that may affect generated code:
required keyword now correctly recognized: Properties using the C# 11 required keyword (via RequiredMemberAttribute / JsonRequiredAttribute) are now properly treated as required in the schema and generated code. Previously these were incorrectly treated as optional.WriteAccessor setting to control property setter syntax (set vs init).JsonLibraryVersion setting for controlling enum attribute generation with System.Text.Json.MinLength validation no longer incorrectly applied to DateTime properties.IncludeFields is enabled.For the full list of changes, see the NJsonSchema v11.6.0 release notes.
Full Changelog: v14.6.3...v14.7.0
v14.7.1 updates to NJsonSchema v11.6.1 , which corrects the handling of the C# required keyword and [JsonRequired] :
These are now treated as presence markers (the property must be present in the JSON) rather than value constraints.
Nullability from the declared type ( string? , T? ) is preserved.
No spurious MinLength=1 on non-nullable strings.
DataAnnotations [Required] semantics remain unchanged (still suppresses nullability and adds MinLength=1 to strings by default, matching its runtime behavior).
For public required string[]? OptionList { get; init; } ( #5359 ):
TypeScript client C# client
v14.7.0 (broken) optionList: string[] ❌ public string[] OptionList ❌
v14.7.1 optionList: string[] | null ✅ public string[]? OptionList ✅
For full details and truth tables across all required / [Required] / [JsonRequired] / [JsonProperty(Required=*)] combinations, see the NJsonSchema v11.6.1 release notes and NJsonSchema #1919 .
Updated packages for CVE-2025-55315 by @erjdev in https://github.com/RicoSuter/NSwag/pull/5299
Full Changelog: https://github.com/RicoSuter/NSwag/compare/v14.6.2...v14.6.3
Full Changelog: v14.6.2...v14.6.3
Fixes EnumValue regression in v14.6.1 by introducing a new JsonLibraryVersion configuration (default 8.0)
Fixes EnumValue regression in v14.6.1 by introducing a new JsonLibraryVersion configuration (default 8.0)
Full Changelog: v14.6.1...v14.6.2
Fix binary operation result type generation for AspNetCore CSharp by @xamele0n in https://github.com/RicoSuter/NSwag/pull/5255
Full Changelog: https://github.com/RicoSuter/NSwag/compare/v14.6.0...v14.6.1
Full Changelog: v14.6.0...v14.6.1
Update NJS v11.5.0, breaking: minimum TypeScript output version is now 4.3 by @RicoSuter in https://github.com/RicoSuter/NSwag/pull/5268
Full Changelog: https://github.com/RicoSuter/NSwag/compare/v14.5.0...v14.6.0
Full Changelog: v14.5.0...v14.6.0
Remove deprecated tslint suppression by @CaringDev in https://github.com/RicoSuter/NSwag/pull/5020
Full Changelog: https://github.com/RicoSuter/NSwag/compare/v14.4.0...v14.5.0
Full Changelog: v14.4.0...v14.5.0
Fix optional parameter ordering in generated TS/CS clients by @lahma in https://github.com/RicoSuter/NSwag/pull/5135
Full Changelog: https://github.com/RicoSuter/NSwag/compare/v14.3.0...v14.4.0
Full Changelog: v14.3.0...v14.4.0
Updated to NJsonSchema v11.2.0, see https://github.com/RicoSuter/NJsonSchema/releases/tag/v11.2.0
Updated to NJsonSchema v11.2.0, see https://github.com/RicoSuter/NJsonSchema/releases/tag/v11.2.0
Microsoft.NET.Tests.Sdk and Verify.XUnit by @Saibamen in https://github.com/RicoSuter/NSwag/pull/5059Full Changelog: https://github.com/RicoSuter/NSwag/compare/v14.2.0...v14.3.0
Updated to NJsonSchema v11.2.0, see https://github.com/RicoSuter/NJsonSchema/releases/tag/v11.2.0
Microsoft.NET.Tests.Sdk and Verify.XUnit by @Saibamen in #5059Full Changelog: v14.2.0...v14.3.0
Support $ref in requestBody by @eatdrinksleepcode in https://github.com/RicoSuter/NSwag/pull/4917
$ref in requestBody by @eatdrinksleepcode in https://github.com/RicoSuter/NSwag/pull/4917Full Changelog: https://github.com/RicoSuter/NSwag/compare/v14.1.0...v14.2.0
$ref in requestBody by @eatdrinksleepcode in #4917Full Changelog: v14.1.0...v14.2.0
Might be breaking change: Remove NET 7 support by @lahma in https://github.com/RicoSuter/NSwag/pull/4896
Full Changelog: https://github.com/RicoSuter/NSwag/compare/v14.0.8...v14.1.0
Update NJS to v11.0.1 by @RicoSuter in https://github.com/RicoSuter/NSwag/pull/4913
Full Changelog: https://github.com/RicoSuter/NSwag/compare/v14.0.7...v14.0.8
Fix loading of correct JSON serializer options, fixes https://github.com/RicoSuter/NSwag/issues/4834, regression of https://github.com/RicoSuter/NSwag
Full Changelog: https://github.com/RicoSuter/NSwag/compare/v14.0.6...v14.0.7
Broken version: Newtonsoft.Json options are not loaded correctly, please use v14.0.7
Broken version: Newtonsoft.Json options are not loaded correctly, please use v14.0.7
Full Changelog: https://github.com/RicoSuter/NSwag/compare/v14.0.5...v14.0.6
Broken version: Newtonsoft.Json options are not loaded correctly, please use v14.0.7
Broken version: Newtonsoft.Json options are not loaded correctly, please use v14.0.7
Broken version: Newtonsoft.Json options are not loaded correctly, please use v14.0.7
Broken version: Newtonsoft.Json options are not loaded correctly, please use v14.0.7
Full Changelog: https://github.com/RicoSuter/NSwag/compare/v14.0.4...v14.0.4
Annotate BaseUrl set with MemberNotNull to prevent CS8618. by @powercode in https://github.com/RicoSuter/NSwag/pull/4739
Full Changelog: https://github.com/RicoSuter/NSwag/compare/v14.0.2...v14.0.3
Minor fix in the Swagger UI (revert and improve https://github.com/RicoSuter/NSwag/pull/4184)
fixed readme code sample, https://github.com/RicoSuter/NSwag/pull/4667
Minor fixes:
Breaking change in IJsonExtensionObject interface (now supports multiple data tuples)
See https://github.com/RicoSuter/NSwag/issues/4524
Breaking changes
Breaking changes
Other changes:
Renamed UseSwaggerUi3 to UseSwaggerUi (v2 has been removed)
Breaking Changes:
Nothing published for this version
Nothing published for this version
Full Changelog: https://github.com/RicoSuter/NSwag/compare/v14.0.0-preview008...v14.0.0-preview009
Full Changelog: https://github.com/RicoSuter/NSwag/compare/v14.0.0-preview008...v14.0.0-preview009
NSwag v14 (preview) by @RicoSuter in https://github.com/RicoSuter/NSwag/pull/3758
Full Changelog: https://github.com/RicoSuter/NSwag/compare/v13.20.0...v14.0.0-preview008
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Update to latest NJsonSchema and Namotion.Reflection libraries
ASP.NET Core OpenAPI Generator: Required path parameters are never nullable
- Improve parameter NRT handling
- Various fixes and improvements
Nothing published for this version
## What's Changed - Added support for .NET 7 Full Changelog: https://github.com/RicoSuter/NSwag/compare/v13.17.0...v13.18.0
Full Changelog: https://github.com/RicoSuter/NSwag/compare/v13.17.0...v13.18.0
Update Namotion.Reflection to v2.1.0
Full Changelog: https://github.com/RicoSuter/NSwag/compare/v13.16.1...v13.17.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Update NJS (fix STJ inheritance code gen)
Revert PR: FileResponse: support for special characters in fileName (+ suppress warning when nullable is enabled in C# clients) #3816
Create generator on demand and keep only settings in OpenApiDocumentRegistration #3855
Remove TypeScript bracket type casting syntax
Bug fixes (reflection and document serialization)
Some bugfixes related to XML Docs rendering (in NJS)
New release with fixed CI pipeline (problem deploying v13.15.2)
Fix MSI installer (correct binary versions)
Breaking change: Use these settings instead of XmlDocsExtensions.ResolveFromNuGetCacheOrDotNetSdk
XmlDocsExtensions.ResolveFromNuGetCacheOrDotNetSdkBreaking change: Migration from DotLiquid to Fluid (reasons: much faster code generation & more strict liquid implementation)
elseif with elsif, fix newline handling (have a look at the updates templates in the repository).Notes:
- Update Swagger UI version - Minor patches
Republish all packages with same versions (new NUKE build and GitHub actions)
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.