NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet, #23 most downloaded on NuGet
.NET models with JSON and YAML writers for OpenAPI specification
Latest stable
3.11.1
Last release 3 days ago
16 Nov 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
12 versions withdrawn
withdrawn after publishing
127 years old
153 releases · first in 1900
Drag across the ruler to compare, or tap a release to open it.
Adds defensive programming by @MaggieKimani1 in https://github.com/microsoft/OpenAPI.NET/pull/973
Full Changelog: https://github.com/microsoft/OpenAPI.NET/compare/1.4.0-preview1...1.4.0-preview2
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Adds support for Copy Constructors by @MaggieKimani1 in https://github.com/microsoft/OpenAPI.NET/pull/853
Full Changelog: https://github.com/microsoft/OpenAPI.NET/compare/1.3.2...1.4.0-preview1
This list of changes was auto generated.
#914: hidi docker image release
#915: - removes unecessary condition for get version step
#892: Add OpenApiContact for ReadFragment
#908: Adding support to write c-style hex strings as strings
#912: Bump Microsoft.OpenApi.OData from 1.0.11-preview2 to 1.0.11-preview3
#910: - adds docker image definition for hidi
#911: Bump Microsoft.OData.Edm from 7.11.0 to 7.12.0
#906: Bump SharpYaml from 1.9.1 to 1.9.2
#903: Bump Microsoft.DotNet.UpgradeAssistant.Extensions.Default.Analyzers from 0.3.326103 to 0.3.330701
#901: Bump Verify.Xunit from 17.1.2 to 17.1.4 <details><summary><b>See More</b></summary>
#902: Bump Verify from 17.1.2 to 17.1.4
#898: Bump Verify.Xunit from 16.8.1 to 17.1.2
#899: hidi release
#867: Bump Microsoft.DotNet.UpgradeAssistant.Extensions.Default.Analyzers from 0.3.310801 to 0.3.326103
#873: Bump FluentAssertions from 6.6.0 to 6.7.0
#894: Bump Verify from 16.8.1 to 17.1.1
#897: Adds entry to the csproj release notes
#896: Bumps conversion lib version and Hidi version
#869: Adding Microsoft SECURITY.MD
#876: - normalizes inlining parameters to kebab case
#875: Update hidi readme.md formatting
#874: Add Hidi read me file
#871: hidi release
#868: Adds OpenAPI convert setting ExpandDerivedTypesNavigationProperties=false
#865: hidi release
#863: Bump Verify.Xunit from 16.7.0 to 16.8.1
#864: enables discriminator in hidi
#857: Bump Microsoft.NET.Test.Sdk from 17.1.0 to 17.2.0
#862: Bump Moq from 4.18.0 to 4.18.1
#859: Bump Moq from 4.17.2 to 4.18.0
#860: Bump Verify from 16.7.0 to 16.7.1
#855: hidi release
#854: - bumps hidi version
#851: Bump SharpYaml from 1.9.0 to 1.9.1
#845: Bump Verify.Xunit from 16.5.4 to 16.7.0
#849: Bump xunit.runner.visualstudio from 2.4.3 to 2.4.5
#843: Bump Microsoft.OData.Edm from 7.10.0 to 7.11.0
#838: Bump github/codeql-action from 1 to 2
#844: Bump Verify from 16.5.4 to 16.7.0
#852: Bump Microsoft.OpenApi.OData from 1.0.10-preview3 to 1.0.10
#831: Add --terse-output Commandline parameter for producing JSON in terse format
#835: Update vNext from master
This list of changes was auto generated.</details>
This list of changes was auto generated.
#828: Release/1.3.0
#826: Fix failing Github release task
#822: Added support for Validation to produce warnings as well as errors
#827: Remove unnecessary reference that made netcoreapp2.1 incompatible
#825: Made ResolveReference public again as it is used by Swashbuckle
#823: Update vnext with Release/1.3.1 preview6 version
#824: Update master with Release/1.3.1 preview6
#821: [bugfix] Resolve local file reference with Schema type properly
#816: Bump Verify.Xunit from 16.4.4 to 16.5.4
#815: Bump FluentAssertions from 6.5.1 to 6.6.0 <details><summary><b>See More</b></summary>
#814: Bump Verify from 16.4.4 to 16.5.4
#809: Bump Microsoft.OpenApi.OData from 1.0.10-preview2 to 1.0.10-preview3
#817: Convert anyOf/oneOf to allOf with first schema when writing v2
#803: Added CSDL filter for entitysets and singletons
#794: Parse Nested postman collections
#619: Fix resolution of external files
#796: Fixes failing script for Hidi exe
#791: Fixed issues related to merge conflicts
#789: Add --clean-output parameter to allow overwriting existing files
#790: Dependabot updates
#767: Simplify openapi spec version for Hidi
#785: Better error handling
#773: - fixes failing hidi release script for exe
#772: - fixes failing hidi release script for exe
#771: - fixes branch filter for deploy jobs
#770: - fixes branch filter for deploy jobs
#761: Release/1.3.1 preview5
#769: latest pipeline and reference updates for the unpublished release
#768: - bumps reference to openapi.odata
#752: updates pipeline definition to align with openapi.odata lib changes
#754: Bump Verify.Xunit from 16.1.2 to 16.3.2
#755: Bump Verify from 16.1.2 to 16.3.2
#757: Bump actions/setup-dotnet from 1 to 2
#758: Bump Moq from 4.16.1 to 4.17.1
#760: Updated versions to preview5
#727: Catch any OpenApiExceptions thrown during parsing and continue processing Schema Components
#756: fixes an issue where hidi would not process async
#750: Publish hidi as a self-contained application
#753: - upgrades odata conversion lib reference in hidi
#744: Migrate all projects to .NET6
#745: Adds Constants for the Scheme and Bearer format types
#743: Upgrade packages
#746: Bump Microsoft.NET.Test.Sdk from 17.0.0 to 17.1.0
#738: Fixed ValidateDocument method in hidi
#739: Fixed validate for Path Parameters so it does not fail for components
#724: Bump Verify.Xunit from 14.14.1 to 16.1.1
#728: Bump System.Text.Json from 6.0.1 to 6.0.2
#723: Bump Verify from 15.2.1 to 16.1.1
#705: Convert csdl files to openapi
#726: Release/1.3.1 preview4
#725: Updated version to preview4
#720: Set Nuget properties in Hidi to align with compliance guidelines during publishing
#716: Release/1.3.1 preview3
#714: Updated versions to preview3
#713: Upgrades to System.Commandline beta2
#697: Align hidi params with kiota
#710: Bump Verify from 15.2.0 to 15.2.1
#708: Bump Verify from 14.14.1 to 15.2.0
#701: Bump FluentAssertions from 6.3.0 to 6.4.0
#695: Release/1.3.1 preview2
#693: Updated version to release new preview
#694: Fix round-tripping of empty media type objects and parsing of encoding style.
#692: Update package version numbers
This list of changes was auto generated.</details>
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
Added service for slicing APIs based on tags and operations
Updated framework dependencies to just .net standard 2.0.
Milestone: https://github.com/microsoft/OpenAPI.NET/milestone/4
Fixes issues described in 1.2.3 milestone
Fixes issues described in 1.2.3 milestone
Nothing published for this version
An optional parameter on the OpenApiString constructor was causing a binary incompatibility with 1.1.4, This release fixes that issue.
An optional parameter on the OpenApiString constructor was causing a binary incompatibility with 1.1.4, This release fixes that issue.
This release contains a number of bugfixes and also introduces the ability to inline references while writing out OpenAPI descriptions. It also remove
This release contains a number of bugfixes and also introduces the ability to inline references while writing out OpenAPI descriptions. It also removes the data type mismatch validator from the default set of validation rules. This validator checked to ensure that the values in examples and schema defaults were compatible with the data types of the schema. This is not a requirement of either OpenAPI or JSON Schema and is particularly tricky to do when schemas are referenced. These validators can be added back by users if desired.
Nothing published for this version
Release contains items described in milestone 1.1.4
Release contains items described in milestone 1.1.4
Enhance OpenAPI walker to visit references.
discriminator propertybinary and byte data format.produces property properly when it is specified in both the document scope and the operation scope, regardless of the order of appearance in the document.Nothing published for this version
Nothing published for this version
See release notes for v1.1.0-preview.1 - v1.1.0-preview.4
See release notes for v1.1.0-preview.1 - v1.1.0-preview.4
Fixed issue with deserialization of V2 schema
Fixed potential security issue with validation regex
Performance improvements for validation and reference resolution
Handle downcasting complex types in parameters for V2 export
Add smoke tests based on Apis.guru
Bug fix: Serializing the OpenApiAny type for double, float, and long now works as expected.
OpenApiAny type for double, float, and long now works as expected.readonly being false when it is in the required list for V2 to comply with the specification.Added IOpenApiExtension interface to be used when creating a new custom extension type.
IOpenApiExtension interface to be used when creating a new custom extension type.OpenApiValidator, one can verify whether a given OpenApiDocument conforms to the specification based on the prescribed set of rules. More rules will be added in future releases.Bug fix: Serializing and deserializing V2.0 formData and body parameters
formData and body parametersconsumes propertyThrowing OpenApiUnsupportedSpecVersionException when spec version in document is not recognized by Reader
OpenApiUnsupportedSpecVersionException when spec version in document is not recognized by ReaderBug fixes: Capitalization of parameter location in V2 serialization, top-level component reference serialization
OpenApiDiagnostic as a result of parsingSupport for OpenApi specificiation v3.0.1
formData parameter when reading V2 documentsNothing published for this version
One column per quarter.