Bump Microsoft.OpenApi from 1.6.22 to 3.7.0

[dependabot]

Updated Microsoft.OpenApi from 1.6.22 to 3.7.0.

Release notes

Sourced from Microsoft.OpenApi's releases.

3.7.0

3.7.0 (2026-06-10)

Features

• add contains/minContains/maxContains members (78475e3)
• add contains/minContains/maxContains members (1a974f8)
• library: add missing json schema properties (9b1aed6)
• library: add missing json schema properties (82f84e0)

Bug Fixes

• library: always copy unevaluated properties (4907d1c)
• library: avoid false circular refs for external schema re-exports (b635242)
• library: avoid false circular refs for external schema re-exports (7a443c2)
• library: remove unshipped schema extension fallback (cf54bb3)
• library: use version-specific schema keyword callbacks (6e22ec6)
• library: use x-jsonschema schema extensions (eb1891a)

3.6.0

3.6.0 (2026-06-01)

Features

• reader: remove ParseNode infrastructure (9b4f45b)
• Significant performance improvements resulting ~40% reduced allocations when parsing JSON descriptions, ~25% for YAML.

3.5.5

3.5.5 (2026-05-28)

Bug Fixes

• reader: preserve Null flag when nullable appears before type in V3.0/V3.1/V3.2 deserializers (2b9d7f4)

3.5.4

3.5.4 (2026-05-26)

Bug Fixes

• library: handle circular schema references (b3cd42b)
• library: handle circular schema references (91a989f)

3.5.3

3.5.3 (2026-04-27)

Bug Fixes

• null reference exception for boolean component schemas (f97f91a)
• null reference exception for boolean component schemas (fe0b50a)
• schema: support boolean schemas in deserializer for OpenAPI 3.1/3.2 (05b44be)

Performance Improvements

• schema: optimize boolean schema deserialization (7316e3f)

3.5.2

3.5.2 (2026-04-14)

Bug Fixes

• hidi: update Microsoft.OpenApi.OData to 3.2.1 (b0a68fb)
• hidi: update Microsoft.OpenApi.OData to 3.2.1 (8c22ab2), closes #​2811

3.5.1

3.5.1 (2026-03-31)

Bug Fixes

• security scheme references serialization (a5acb89)

3.5.0

3.5.0 (2026-03-20)

Features

• library: add Extensions support for schema references in v3.1/v3.2; add SerializeAsV32 with loop detection (9b422bf)

Bug Fixes

• a bug where path parameter validation would fail if they contained forbidden JSON pointer characters (ef55b2c)
• a bug where path parameter validation would fail if they contained forbidden JSON pointer characters (4b3164a)
• double encoding of json pointer for invalid reference rule (b246cd0)
• encoding of special characters for JSON paths (4c757e1)
• library: do not emit unevaluatedProperties for non-object schemas (852fb4c)
• library: do not emit unevaluatedProperties for non-object schemas (19538aa)
• library: enforce spec-compliant $ref serialization; add Extensions support for schema references in v3.1/v3.2 (9bf61de)
• potential double encoding of paths (471a61a)

3.4.0

3.4.0 (2026-03-04)

Features

• library: preserve PatternProperties as x-jsonschema-patternProperties extension for OpenAPI v2/v3.0 serialization (d969fdc)
• library: Preserve PatternProperties via x-jsonschema-patternProperties extension for OpenAPI v2/v3.0 (16ab5e4)
• securityscheme: add oauth2MetadataUrl support (OpenAPI 3.2) (4509488)

Bug Fixes

• implement unevaluatedProperties as schema per JSON Schema 2020-12 (#​2728) (7c13fb3)
• library: serialize additionalProperties schema in OpenAPI V2 (f3165fa)
• library: serialize additionalProperties schema in OpenAPI V2 documents (3d07756)
• optimize parsing V3.1 documents by reducing GetLocation method allocation on hot path(#​2748) (f690681)

3.3.1

3.3.1 (2026-01-22)

Features

• models: add shared Content interface (#​2695) (338566f)

Bug Fixes

• broken binary compatibility due to interface changes in previous version (d96bba7)

3.3.0

3.3.0 (2026-01-21)

Features

• models: add shared Content interface (9e13b25)
• models: add shared Content interface (#​2695) (9e13b25)
• models: support mutualTLS security scheme (a4efdfe)

3.2.0

3.2.0 (2026-01-19)

Features

• hidi validate command now logs warnings (76a3c0f)
• hidi validate command now logs warnings (62e7d56)

Bug Fixes

• discriminator property validation fails any/allOf cases when it shouldn't (fb6cecc)
• discriminator property validation fails any/allOf cases when it shouldn't (a8fb81c)

3.1.3

3.1.3 (2026-01-16)

Bug Fixes

• Support custom tag ordering (008576c)
• Support custom tag ordering (7610d07)

3.1.2

3.1.2 (2026-01-06)

Bug Fixes

• correct error pointer when extension parser throws OpenApiException (43c75a9)
• wrap extension parser calls in try-catch to ensure correct error pointers (50b44aa)

3.1.1

3.1.1 (2025-12-18)

Bug Fixes

• schema: always serialize additionalProperties: false (6651c36)
• schema: always serialize additionalProperties: false (e36fc95)

3.1.0

3.1.0 (2025-12-17)

Features

• Add type: "null" downcasting when in oneOf and anyOf for OpenAPI v3 (782cf8d)

3.0.3

3.0.3 (2025-12-16)

Bug Fixes

• load JSON documents that are preceded by multiple whitespace (6461bac)
• non-seekable json streams would fail to load as a document (2436d73)
• reading streams in an asp.net context would cause async exceptions (f9e5248)

3.0.2

3.0.2 (2025-12-08)

Bug Fixes

• additional properties serialization should not emit a schema in v2 (946cba9)
• additional properties serialization should not emit booleans in v3.1+ (946cba9)

3.0.1

3.0.1 (2025-11-17)

Bug Fixes

• empty strings should be quoted in yaml (8d215f9)
• empty strings should be quoted in yaml (0ca10db)

3.0.0

3.0.0 (2025-11-11)

⚠ BREAKING CHANGES

• adds support for OpenAPI 3.2.0

Note: Please refer to the upgrade guide for a detailed description of the breaking changes.

Note: ASP.net users should remain on version 1.X for ASP.net < 10, and version 2.X for ASP.net 10, this new major version will be implemented in a future version of ASP.net, more information

Features

• adds support for OpenAPI 3.2.0 (765a8dd)

Special thanks

• Matthieu Costabello

2.9.0

2.9.0 (2026-06-10)

Features

• add contains/minContains/maxContains members (fadb422)
• library: add missing json schema properties (db41a3c)

Bug Fixes

• library: always copy unevaluated properties (3951a31)
• library: avoid false circular refs for external schema re-exports (a058913)
• library: avoid false circular refs for external schema re-exports (1bace68)
• library: merge contains compat members into missing properties (7dc45e1)
• library: remove unshipped schema extension fallback (b301827)
• library: use version-specific schema keyword callbacks (f93d76a)
• library: use x-jsonschema schema extensions (ec04a7f)

2.8.0

2.8.0 (2026-06-01)

Features

• reader: remove ParseNode infrastructure (d7c6a9d)
• Significant performance improvements resulting ~40% reduced allocations when parsing JSON descriptions, ~25% for YAML.

2.7.6

2.7.6 (2026-05-28)

Bug Fixes

• reader: preserve nullable Null flag when type appears after nullable in V3.1/V3.2 deserializers (288e95a)

2.7.5

2.7.5 (2026-05-26)

Bug Fixes

• library: handle circular schema references (acd5088)
• library: handle circular schema references (6bcac39)

2.7.4

2.7.4 (2026-04-27)

Bug Fixes

• null reference exception for boolean component schemas (cc13028)
• schema: support boolean schemas in deserializer for OpenAPI 3.1/3.2 (48aaf23)

Performance Improvements

• schema: optimize boolean schema deserialization (fe6f513)

2.7.3

2.7.3 (2026-04-14)

Bug Fixes

• hidi: update Microsoft.OpenApi.OData to 2.2.1 (1e01cd5)
• hidi: update Microsoft.OpenApi.OData to 2.2.1 (c890703), closes #​2812

2.7.2

2.7.2 (2026-03-31)

Bug Fixes

• security requirement reference serialization (0945eec)

2.7.1

2.7.1 (2026-03-20)

Bug Fixes

• a bug where path parameter validation would fail if they contained forbidden JSON pointer characters (2efd2b2)
• library: do not emit unevaluatedProperties for non-object schemas (28d614f)
• library: enforce spec-compliant $ref serialization; add Extensions support for schema references in v3.1/v3.2 (7640a8a)

2.7.0

2.7.0 (2026-03-05)

Features

• add UnevaluatedPropertiesSchema support to IOpenApiSchema (fb691d6)
• library: preserve PatternProperties as x-jsonschema-patternProperties extension for OpenAPI v2/v3.0 serialization (dd5085a)

Bug Fixes

• address PR feedback on UnevaluatedProperties implementation (80fc0f6)
• correct deserialization and test for UnevaluatedPropertiesSchema (a4d66fc)
• library: serialize additionalProperties schema in OpenAPI V2 (99b653c)
• library: serialize additionalProperties schema in OpenAPI V2 (cef7996)
• optimize parsing V3.1 documents by reducing GetLocation method allocation on hot path(#​2748) (91e697b)
• optimize parsing V3.1 documents by reducing GetLocation method allocation on hot path(#​2748) (06c58a5)

2.6.1

2.6.1 (2026-01-22)

Bug Fixes

• broken binary compatibility due to interface changes in previous version (06f2b85)

2.6.0

2.6.0 (2026-01-21)

Features

• models: add shared Content interface (80e4bbf)
• models: add shared Content interface (#​2695) (338566f)
• models: add shared Content interface (#​2695) (80e4bbf)
• models: support mutualTLS security scheme (f9cf5b8)

2.5.0

2.5.0 (2026-01-19)

Features

• hidi validate command now logs warnings (1d3d085)
• hidi validate command now logs warnings (18ed5ac)

Bug Fixes

• discriminator property validation fails any/allOf cases when it shouldn't (ff6e411)
• discriminator property validation fails any/allOf cases when it shouldn't (7def73d)

2.4.3

2.4.3 (2026-01-16)

Bug Fixes

• Support custom tag ordering (008576c)
• Support custom tag ordering (7610d07)

2.4.2

2.4.2 (2025-12-22)

Bug Fixes

• wrap extension parser calls in try-catch to ensure correct error pointers (63cf4a3)
• wrap extension parser calls in try-catch to ensure correct error pointers (458cabe)

2.4.1

2.4.1 (2025-12-18)

Bug Fixes

• schema: always serialize additionalProperties: false (6651c36)
• schema: always serialize additionalProperties: false (e36fc95)

2.4.0

2.4.0 (2025-12-17)

Features

• Add type: "null" downcasting when in oneOf and anyOf for OpenAPI v3 (782cf8d)

2.3.12

2.3.12 (2025-12-15)

Bug Fixes

• load JSON documents that are preceded by multiple whitespace (640e59a)
• non-seekable json streams would fail to load as a document (76b0159)
• non-seekable json streams would fail to load as a document (2436d73)
• reading streams in an asp.net context would cause async exceptions (f9e5248)

2.3.11

2.3.11 (2025-12-08)

Bug Fixes

• additional properties serialization should not emit a schema in v2 (946cba9)
• additional properties serialization should not emit a schema in v2 fix: additional properties serialization should not emit booleans in v3.1+ (275dd9d)
• additional properties serialization should not emit booleans in v3.1+ (946cba9)

2.3.10

2.3.10 (2025-11-17)

Bug Fixes

• empty strings should be quoted in yaml (e919b33)
• empty strings should be quoted in yaml (0ca10db)

2.3.9

2.3.9 (2025-11-06)

Bug Fixes

• a bug where null sentinel value would appear in YAML documents (15618e1)

2.3.8

2.3.8 (2025-10-27)

Bug Fixes

• an issue where numeric property names would be missing quotes in yaml conversion (da43c98)
• quote property names in yaml that match boolean values (39a9f41)
• yaml blocks and line returns (b053848)

2.3.7

2.3.7 (2025-10-24)

Bug Fixes

• adds a null value sentinel to enable roundtrip serializations of JsonNode typed properties (337c6eb)
• adds a null value sentinel to enable roundtrip serializations of JsonNode typed properties (63b2b98)
• fixes a bug where yaml null values would end up as a string "null" during roundtrip serialization (6e62de2)
• fixes a bug where yaml null values would end up as a string "null" during roundtrip serialization (994184b)
• YamlConverter adding extra quotes to string values when converting from JSON to YAML (ccfebc8)

Performance Improvements

• do not duplicate nodes when indexing (dbbbf13)
• only initialize map node nodes on demand (bdb5264)
• reduce allocations in mapnode (f58aad2)
• removes the lazy initialization since the node is always enumerated (1c96521)
• switches to lazy instantiation (d3c758b)
• use deep equals for comparison to reduce allocations (6ce3214)

2.3.6

2.3.6 (2025-10-20)

Bug Fixes

• a bug where empty collections would not be serialized for default values (4c4d257)

2.3.5

2.3.5 (2025-10-14)

Bug Fixes

• use settings for terse output in serialization extension methods (246039b)
• use settings for terse output in serialization extension methods (8b91278)

2.3.4

2.3.4 (2025-10-06)

Bug Fixes

• Improve server creation and URL handling logic to maintain port (3e6ee80)
• missing deserialization for header content property in 3.1 and 3.0 (717f154)
• missing deserialization for header content property in 3.1 and 3.0 (0fdfae1)

2.3.3

2.3.3 (2025-10-02)

Bug Fixes

• typo in allowReserved property name for deserialization (1633453)
• typo in allowReserved property name for deserialization (f7e34be)

2.3.2

2.3.2 (2025-09-19)

Bug Fixes

• Fix URL processing in InternalLoad method would not detect the filename/scheme properly in some scenarios (d93689c)
• OpenApiEncoding explode property serialization defaults with form style (ae03eab)

2.3.1

2.3.1 (2025-09-08)

Bug Fixes

• file access for "file" URI scheme with special characters (6dded81)

2.3.0

2.3.0 (2025-08-29)

Features

• adds the detected format as part of the diagnostic (#​2482) (59d7c81)
• adds the detected format to the diagnostics (59d7c81)

2.2.0

2.2.0 (2025-08-25)

Features

• add Validation Rule for path operations to not have a request body (d101fc3)

Bug Fixes

• missing examples when one example is with an empty array. (cb1c496)

2.1.0

2.1.0 (2025-08-20)

Features

• adds a default validation rule for unresolved references (90b3966)

Bug Fixes

• Improve OpenApiWalker performance (a007c03)
• Validate schema property is not null (3326022)

2.0.1

2.0.1 (2025-08-18)

Bug Fixes

• add missing disposable for stream (0c1ccbd)

2.0.0

2.0.0 (2025-07-10)

Features

• General availability of version 2 with support for OpenAPI 3.1!!! 🎉🎉🎉 (a02d74c)

Bug Fixes

• inconsistent visibility of properties in current keys class (cb9772f)
• removes extraneous default value constant (bf8d0b6)
• removes loop methods from parsing context as its available in loop detector instead (de3531b)
• removes public mermaid types that were not usuable (ef7ae33)
• removes redundant marker interface (5a055f9)
• switches to a getter for API consistency (7975082)
• unconsistent visibility of properties in current keys class (d0c20ab)
• visibility of extension methods (1e9112a)

2.0.0-preview9

2.0.0-preview9 (2025-02-21)

Features

• add support for dependentRequired (75d7a66)

Bug Fixes

• an issue where deprecation extension parsing would fail (5db8757)
• an issue where deprecation extension parsing would fail (b59864c)
• refactor ToIdentifier() to normalize flaggable enums (#​2156) (b80e934)

2.0.0-preview8

2.0.0-preview8 (2025-02-17)

Bug Fixes

• a bug where external reference loading for local files would not work on linux (df99a00)
• add meaningful exception message during validation (4a6547d)
• add meaningful exception message during validation (74d20ed)
• adds a cancellation token argument to external document loading (a5ffab1)
• parsing failure on nodes set to null (20aacc1)
• parsing failure on nodes set to null (4245de9)

2.0.0-preview7

2.0.0-preview7 (2025-02-06)

Bug Fixes

• do not write null for types on parameters in v2 (f889937)
• do not write null for types on parameters in v2 (4aef7b7)

2.0.0-preview6

2.0.0-preview6 (2025-02-05)

Features

• adds a net8 target to benefit from all the conditional compilation (a201aa2)
• adds components registration method for schemas (10e548a)
• adds deconstructor to read result (79336f6)
• adds deconstructor to read result (d8c1593)
• adds to identifier mapping to non nullable enum (bd9622e)
• bumps target OAS version to 3.1.1 (9e8d8a4)
• configure AOT for trimming compatibility (b4f9c3e)
• makes document optional (754f763)
• makes the reference interface covariant (7405f3c)
• splits described and summarized interfaces (2a10cd9)

Bug Fixes

• 3.0 serialization when type is set to null (920a51a)
• a bug where 3.0 downcast of type null would not work (6b636d5)
• a bug where 3.0 downcast of type null would not work (ac05342)
• a flaky behaviour for format property serialization (3ea1fa9)
• a flaky behaviour for format property serialization (52981d4)
• additional 3.1.0 constants after merge and v2 release (9e8d8a4)
• adds generic shallow copy method to avoid inadvertent conversions of references to schemas (e4c14a4)
• adds missing culture argument to date serialization (45329e4)
• adds missing null prop operator to proxy properties (8361069)
• adds missing null propagation operators for callback and header references (0cb4ccb)
• adds support for all component types (8a73b54)
• aligns callback parameter name with interface (68b25cc)
• aligns missing properties for override (e3325b9)
• aligns parameter name with interface definition for example (d7e1f91)
• aligns reference copy constructors (ce93aa7)
• aligns to null propagation operator (8d57b81)
• allow registration of component references (14750dc)
• an empty security requirement should not result in an object during serialization (1c6fd8e)
• build passes (ea68427)
• callback reference proxy implementation (028d60b)
• callback reference proxy implementation (2cbb0fa)
• components schema copy (88daad5)
• conditional version for extension causes invalid json (4030c1f)
• conditional version for extension causes invalid json (0ce92cc)
• date time and date time offset shifting zones (a6a44a7)
• default settings in case of null value (ab2ddf0)
• do not allow null argument for example copy constructor (aa80b19)
• do not copy host document as it negatively impact performance (1043e4e)
• do not copy host document as it negatively impact performance (a46e857)
• do not emit a type array in 3.1 when unnecessary (3b3d0e6)
• draft security scheme reference proxy design pattern (1bd2624)
  ... (truncated)

2.0.0-preview5

Changes:

• #​2077: Release v2.0.0-preview5
• #​2076: Fix: Error validating OpenAPI using hidi preview
• #​2074: Bump preview versions
• #​2046: fix/reference copy
• #​2072: chore(deps): bump coverlet.collector from 6.0.3 to 6.0.4
• #​2071: chore(deps): bump docker/build-push-action from 6.11.0 to 6.12.0
• #​2073: chore(deps): bump coverlet.msbuild from 6.0.3 to 6.0.4
• #​2070: chore(deps): bump FluentAssertions from 7.0.0 to 7.1.0
• #​2063: feat: configure AOT for trimming compatibility
• #​2064: chore/reduce fluent assertions dependency

See More

• #​2033: fix: passes missing host document references to all layers
• #​2065: chore(deps): bump System.Formats.Asn1 and Microsoft.Windows.Compatibility
• #​2032: fix: side effects in tag references
• #​2061: chore(deps): bump System.Formats.Asn1 from 9.0.0 to 9.0.1
• #​2057: chore(deps): bump Microsoft.Extensions.Logging, Microsoft.Extensions.Logging.Abstractions and Microsoft.Extensions.Logging.Debug
• #​2059: chore(deps): bump Verify.Xunit from 28.8.1 to 28.9.0
• #​2056: chore(deps): bump docker/build-push-action from 6.10.0 to 6.11.0
• #​2053: make IDiagnosticExtensions internal and fix namespace
• #​2054: chore(deps): bump xunit.runner.visualstudio from 3.0.0 to 3.0.1
• #​2049: fix: enum parsing when encountering unknown values should not default to first member
• #​2051: fix/async surface
• #​2050: chore(deps): bump xunit from 2.9.2 to 2.9.3
• #​2031: fix/reference proxy single copy
• #​2041: fix: v2 references for properties do not work as expected
• #​2044: chore(deps): bump Verify.Xunit from 28.7.0 to 28.8.1
• #​2042: fix: v2 request body content null propagation
• #​2043: fix: conditional version for extension causes invalid json
• #​2038: fix/clone api
• #​2039: fix/json node serialization
• #​2040: chore/remove obsolete
• #​2037: fix/missing culture
• #​2035: chore(deps): bump coverlet.msbuild from 6.0.2 to 6.0.3
• #​2034: chore(deps): bump coverlet.collector from 6.0.2 to 6.0.3
• #​2028: dev
• #​2027: chore: bumps preview version
• #​2026: fix: specifies encoding for net fx
• #​2024: feat: adds deconstructor to read result
• #​2023: fix: enum description number values
• #​2025: chore(deps): bump Verify.Xunit from 28.6.1 to 28.7.0
• #​2021: fix/ci tag value to main
• #​2019: fix: reverts to a regular variable for the tag value
• #​2015: release of preview 3
• #​2017: fix/ci hidi gh upload to main
• #​2016: fix/ci hidi gh upload
• #​1975: Refactor readers to reduce surface area
  ... (truncated)

2.0.0-preview4

Changes:

• #​2028: dev
• #​2027: chore: bumps preview version
• #​2026: fix: specifies encoding for net fx
• #​2024: feat: adds deconstructor to read result
• #​2023: fix: enum description number values
• #​2025: chore(deps): bump Verify.Xunit from 28.6.1 to 28.7.0
• #​2021: fix/ci tag value to main
• #​2019: fix: reverts to a regular variable for the tag value
• #​2015: release of preview 3
• #​2017: fix/ci hidi gh upload to main

See More

• #​2016: fix/ci hidi gh upload
• #​1975: Refactor readers to reduce surface area
• #​2014: chore/v1 sync
• #​2008: ci: fixes hidi gh release
• #​2005: ci: updates main with the latest ci changes
• #​2003: chore(deps): bump Verify.Xunit from 28.2.0 to 28.6.1
• #​2001: ci/align branches
• #​1999: chore: fixes extraneous master references
• #​2000: fix: sets hidi version to a preview
• #​1997: chore/linting
• #​1982: Add support for handling unrecognized keywords
• #​1981: Rename Read Result properties
• #​1996: chore: adds baywet to code owners
• #​1993: chore(deps): bump Verify.Xunit from 28.5.0 to 28.6.0
• #​1994: chore(deps): bump PublicApiGenerator from 11.2.0 to 11.3.0
• #​1939: Fix tags serialization bug
• #​1992: chore(deps): bump xunit.runner.visualstudio from 2.8.2 to 3.0.0
• #​1990: chore(deps): bump Verify.Xunit from 28.4.0 to 28.5.0
• #​1988: Bump preview versions
• #​1984: chore(deps): bump PublicApiGenerator from 11.1.0 to 11.2.0
• #​1986: chore(deps): bump Microsoft.OData.Edm from 8.2.2 to 8.2.3
• #​1979: chore(deps): bump FluentAssertions from 6.12.2 to 7.0.0
• #​1978: Fix: Adds missing security metadata to the pipeline
• #​1977: chore(deps): bump docker/build-push-action from 6.9.0 to 6.10.0
• #​1976: chore(deps): bump Verify.Xunit from 28.3.2 to 28.4.0
• #​1955: Fix: Empty paths object is now failing for version 3.0.0
• #​1943: Add support for JSON schema const keyword in OpenApiSchema
• #​1956: Fix: Workbench fails because of a missing format parameter
• #​1942: Use range for STJ reference and suppress warnings
• #​1945: chore(deps): bump Microsoft.NET.Test.Sdk from 17.11.1 to 17.12.0
• #​1944: chore(deps): bump Microsoft.OData.Edm from 8.2.1 to 8.2.2
• #​1941: chore(deps): bump Verify.Xunit from 28.3.1 to 28.3.2
• #​1938: Fix link to OpenAPI specification
• #​1936: chore(deps): bump Verify.Xunit from 28.2.1 to 28.3.1
• #​1932: chore(deps): bump Microsoft.Extensions.Logging, Microsoft.Extensions.Logging.Abstractions, Microsoft.Extensions.Logging.Console and System.Text.Json
  ... (truncated)

2.0.0-preview3

Changes:

• #​2021: fix/ci tag value to main
• #​2015: release of preview 3
• #​2017: fix/ci hidi gh upload to main
• #​2016: fix/ci hidi gh upload
• #​1975: Refactor readers to reduce surface area
• #​2014: chore/v1 sync
• #​2008: ci: fixes hidi gh release
• #​2005: ci: updates main with the latest ci changes
• #​2003: chore(deps): bump Verify.Xunit from 28.2.0 to 28.6.1
• #​2001: ci/align branches

See More

• #​1999: chore: fixes extraneous master references
• #​2000: fix: sets hidi version to a preview
• #​1997: chore/linting
• #​1982: Add support for handling unrecognized keywords
• #​1981: Rename Read Result properties
• #​1996: chore: adds baywet to code owners
• #​1993: chore(deps): bump Verify.Xunit from 28.5.0 to 28.6.0
• #​1994: chore(deps): bump PublicApiGenerator from 11.2.0 to 11.3.0
• #​1939: Fix tags serialization bug
• #​1992: chore(deps): bump xunit.runner.visualstudio from 2.8.2 to 3.0.0
• #​1990: chore(deps): bump Verify.Xunit from 28.4.0 to 28.5.0
• #​1988: Bump preview versions
• #​1984: chore(deps): bump PublicApiGenerator from 11.1.0 to 11.2.0
• #​1986: chore(deps): bump Microsoft.OData.Edm from 8.2.2 to 8.2.3
• #​1979: chore(deps): bump FluentAssertions from 6.12.2 to 7.0.0
• #​1978: Fix: Adds missing security metadata to the pipeline
• #​1977: chore(deps): bump docker/build-push-action from 6.9.0 to 6.10.0
• #​1976: chore(deps): bump Verify.Xunit from 28.3.2 to 28.4.0
• #​1955: Fix: Empty paths object is now failing for version 3.0.0
• #​1943: Add support for JSON schema const keyword in OpenApiSchema
• #​1956: Fix: Workbench fails because of a missing format parameter
• #​1942: Use range for STJ reference and suppress warnings
• #​1945: chore(deps): bump Microsoft.NET.Test.Sdk from 17.11.1 to 17.12.0
• #​1944: chore(deps): bump Microsoft.OData.Edm from 8.2.1 to 8.2.2
• #​1941: chore(deps): bump Verify.Xunit from 28.3.1 to 28.3.2
• #​1938: Fix link to OpenAPI specification
• #​1936: chore(deps): bump Verify.Xunit from 28.2.1 to 28.3.1
• #​1932: chore(deps): bump Microsoft.Extensions.Logging, Microsoft.Extensions.Logging.Abstractions, Microsoft.Extensions.Logging.Console and System.Text.Json
• #​1931: chore: removes newtonsoft dependency all together
• #​1927: chore(deps): bump Microsoft.OData.Edm from 8.2.0 to 8.2.1
• #​1926: chore(deps): bump Microsoft.Extensions.Logging and Microsoft.Extensions.Logging.Abstractions
• #​1928: chore(deps): bump Microsoft.VisualStudio.Threading.Analyzers from 17.11.20 to 17.12.19
• #​1925: chore(deps): bump Verify.Xunit from 28.2.0 to 28.2.1
• #​1915: fix: multiple performance fixes for type serialization feat: adds to identifier mapping to non nullable enum
• #​1919: chore(deps): bump Microsoft.Extensions.Logging.Abstractions from 8.0.2 to 9.0.0
  ... (truncated)

2.0.0-preview2

Changes:

• #​1914: Release hidi and libs
• #​1913: Bump up libs and hidi versions
• #​1894: feature/3.1.1
• #​1823: feature/3 0 4
• #​1912: chore(deps): bump Verify.Xunit from 28.0.0 to 28.2.0
• #​1909: chore(deps): bump Microsoft.OData.Edm from 8.1.0 to 8.2.0
• #​1910: chore(deps): bump FluentAssertions from 6.12.1 to 6.12.2
• #​1908: Release hidi
• #​1907: Bump hidi version
• #​1906: V2-preview1 release

See More

• #​1904: V2.0-preview1 release
• #​1903: Sync latest vnext changes
• #​1897: Define JSON schema's Type property as a flaggable enum to allow storing multiple values
• #​1900: chore(deps): bump Verify.Xunit from 27.1.0 to 28.0.0
• #​1888: Remove DataTypeMismatch validation rule from the default ruleset
• #​1899: OpenApiSchema refactor to remove recursive keywords
• #​1898: Release Hidi
• #​1896: Bump up hidi and conversion lib versions
• #​1890: Update workbench tool to parse 3.1 and YAML docs
• #​1895: chore(deps): bump Verify.Xunit from 27.0.1 to 27.1.0
• #​1892: docs: fixes doc comments to align with changes made in #​1883
• #​1883: fix: emits number for integer formats
• #​1893: merge/vnext to release2
• #​1886: use nameof for CallerArgumentExpression
• #​1887: Simplify null/empty string checks
• #​1885: Release Hidi lib.
• #​1884: Bump, Release Hidi
• #​1881: chore(deps): bump Microsoft.OData.Edm from 8.0.2 to 8.1.0
• #​1882: chore(deps): bump Microsoft.OpenApi.OData from 2.0.0-preview.5 to 2.0.0-preview.6
• #​1877: Bump Verify.Xunit from 26.6.0 to 27.0.1
• #​1873: Released Hidi
• #​1871: Bumps up conversion lib. and hidi versions
• #​1870: ci: removes zengin since he doesn't have access to the repo anymore
• #​1869: Bump Microsoft.OpenApi.OData from 2.0.0-preview.3 to 2.0.0-preview.4
• #​1868: Bump Microsoft.Extensions.Logging.Debug from 8.0.0 to 8.0.1
• #​1867: Bump Microsoft.Extensions.Logging.Console from 8.0.0 to 8.0.1
• #​1866: Sync v2 branch with the latest changes in vnext
• #​1865: Bump v2 lib versions to 2.0.0-preview1
• #​1863: Bump Microsoft.Extensions.Logging and Microsoft.Extensions.Logging.Abstractions
• #​1862: Bump System.Text.Json from 8.0.4 to 8.0.5
• #​1864: Bump Microsoft.Windows.Compatibility from 8.0.8 to 8.0.10
• #​1861: Sync vnext changes with the v2 branch
• #​1809: Use ConcurrentDictionary For Improving GetEnumFromDisplayName
• #​1857: Avoid buffering JSON data into a new MemoryStream during parsing
• #​1856: Remove validation rule to make paths and webhooks optional
  ... (truncated)

2.0.0-preview10

2.0.0-preview10 (2025-02-27)

Features

• deduplicates tags at the document level (93c468e)
• tags references are now deduplicated as well (763c0c1)

Bug Fixes

• add logic for serializing date time objects (23395c5)
• adds missing cancellation parameter to async method (243a111)
• avoid creating new http clients to load additional documents of the workspace (0f23798)
• deduplicates exclusive min/max properties in the object model (08414a1)
• deduplicates exclusive min/max properties in the object model (0d5b471)
• moves the http client for the reader to settings so it can be passed by client application (9b910f3)
• OpenAPIDocument JsonSchemaDialect property is now a URI (45977b5)
• openapischema schema property is now a Uri (452a6b9)
• primitive parsing for strings as DateTimes is too greedy (4ee1d8b)
• removes static readers registry (fe7a2fd)
• use a single http client in hidi (9386fae)

2.0.0-preview1

Overview

Version 2.0-preview1 brings major enhancements, including OpenAPI 3.1 support, improved performance, and bug fixes to enhance user experience. These changes introduce some breaking changes, so migrating to this new version may require updates in existing implementations.

Upgrade Steps

• Bump up Microsoft.OpenApi and Microsoft.OpenApi.Readers packages to 2.0.0-preview1 from NuGet.

Breaking Changes

1. Update namespaces

Since most of the loading code has moved to the core library, you will be required to update the namespaces in your classes to reflect the change.

Example:
If you're using an instance of our OpenApiReaderSettings, you'll need to update the namespace from Microsoft.OpenApi.Readers to Microsoft.OpenApi.Reader

2. Use Load/LoadAsync/Parse pattern for loading OpenApi documents

We've introduced a simplified static loading pattern for OpenAPI documents, removing the need for a secondary reader.
We have also introduced a registry class that allows users to register different OpenAPI format providers and their implementations for customized scenarios.

Reading from a JSON stream:

    var settings = new OpenApiReaderSettings();
    var readResult = OpenApiDocument.Load(stream, "json", settings);
    var doc = readResult.OpenApiDocument;

To enable YAML parsing, you'll have to register our OpenApiYamlReader with our reader registry for us to take a dependency on the SharpYaml library.

Reading from a YAML stream:

    OpenApiReaderRegistry.RegisterReader(OpenApiConstants.Yaml, new OpenApiYamlReader());
    var doc = OpenApiDocument.Load(stream, "yaml", settings).OpenApiDocument;

Reading string input:

    var doc = OpenApiDocument.Parse(input, "yaml").OpenApiDocument;

Reading from a file path or URL:

    var doc = await OpenApiDocument.LoadAsync(filePath).OpenApiDocument;

3. Migration to JsonNode for examples and extensions

Schema examples and extensions now use JsonNode instead of IOpenApiAny, ensuring JSON Schema compatibility and fixing parsing errors.
You'll be required to import the System.Text.Json.Nodes namespace to facilitate this.

v1.x example:

    Example = new OpenApiObject
    {
        ["name"] = new OpenApiString("Puma"),
        ["id"] = new OpenApiLong(1)
 ... (truncated)

## 2.0.0-preview.31

## [2.0.0-preview.31](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.30...v2.0.0-preview.31) (2025-07-02)


### Bug Fixes

* bumps openapi.net.odata to fix two critical bugs in hidi ([00c3018](https://github.com/microsoft/OpenAPI.NET/commit/00c30181214b35f4817be0cbd3827d765efd04d9))


## 2.0.0-preview.30

## [2.0.0-preview.30](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.29...v2.0.0-preview.30) (2025-07-02)


### Bug Fixes

* migration of hidi to the latest version of system.commandline ([a5f8721](https://github.com/microsoft/OpenAPI.NET/commit/a5f8721a18e93ee881cfee371ba6d23ce0c55ae4))
* throw on circular reference ([e14258d](https://github.com/microsoft/OpenAPI.NET/commit/e14258dd2a8639702c8e0bc81a643874d207facb))
* upgrades openapi.odata to avoid hidi failing to load ([6735397](https://github.com/microsoft/OpenAPI.NET/commit/67353976b8a17dcb6760223d06c097469fa6f794))
* validation to accept lowercase status code ranges (4xx, 5xx) in OpenAPI responses ([09f661f](https://github.com/microsoft/OpenAPI.NET/commit/09f661f0ff0511d5937fad49ae8a6182b1ea1aff))

## 2.0.0-preview.29

## [2.0.0-preview.29](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.28...v2.0.0-preview.29) (2025-06-18)


### Bug Fixes

* avoid stack overflow on cyclical references ([06cc025](https://github.com/microsoft/OpenAPI.NET/commit/06cc025dca43d24955bcd205facefa4347d3f0c7))

## 2.0.0-preview.28

## [2.0.0-preview.28](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.27...v2.0.0-preview.28) (2025-06-16)


### Bug Fixes

* sub-schema references are invalid ([92db49b](https://github.com/microsoft/OpenAPI.NET/commit/92db49b98ade782de3dec229936c100a1339b491))
* sub-schema references are invalid ([75d1d2b](https://github.com/microsoft/OpenAPI.NET/commit/75d1d2b62a6fab3727047be5c0e10b9987ad9f37))

## 2.0.0-preview.27

## [2.0.0-preview.27](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.26...v2.0.0-preview.27) (2025-06-13)


### Bug Fixes

* implementation drift between the different version services ([1ed02e3](https://github.com/microsoft/OpenAPI.NET/commit/1ed02e3cbe7a6b484ee7db224e056ae2f0244a30))
* implementation drift between the different version services ([2514526](https://github.com/microsoft/OpenAPI.NET/commit/25145266a70a961e6899368951d95ce41fe55f5b))
* relative uri in json schema references would not parse appropriately or provide feedback to the user ([940945d](https://github.com/microsoft/OpenAPI.NET/commit/940945df29bea338a22553a3ddfb7e61853cb4e7))
* relative uri in json schema references would not parse appropriately or provide feedback to the user ([e0bceaa](https://github.com/microsoft/OpenAPI.NET/commit/e0bceaaa39e8e475652b390324254149e867f39f))
* warn instead of error out when $schema is present in the document ([388d6f7](https://github.com/microsoft/OpenAPI.NET/commit/388d6f79b4b45d1c30bddbff66dd79eef2d4e4b7))
* warn instead of error out when $schema is present in the document ([7c7b053](https://github.com/microsoft/OpenAPI.NET/commit/7c7b053b543ebdedf05b0357175fea3dc9d345db))

## 2.0.0-preview.26

## [2.0.0-preview.26](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.25...v2.0.0-preview.26) (2025-06-12)


### Bug Fixes

* a bug where relative relative and sub-component JSON references would not resolve properly ([b7bc6be](https://github.com/microsoft/OpenAPI.NET/commit/b7bc6be4a05f1001130efb9af0b677dbec3055bc))
* a bug where relative relative and sub-component JSON references would not resolve properly ([c53165c](https://github.com/microsoft/OpenAPI.NET/commit/c53165c72fae25ba0864a9f3c52d42e4ee05184d))
* recursive relative reference resolution ([873acd4](https://github.com/microsoft/OpenAPI.NET/commit/873acd45eb6adecdc4219a08b028ddf35a568f01))
* recursive relative reference resolution ([f296505](https://github.com/microsoft/OpenAPI.NET/commit/f296505b7123f35b2e45eedc9118c59b8f925cbd))
* upgrades sharp yaml to avodi signing issues on netfx ([5dc7e81](https://github.com/microsoft/OpenAPI.NET/commit/5dc7e81fa7fad856edd96640ea7ee0e23e25a7f2))
* upgrades sharp yaml to avodi signing issues on netfx ([4db5c1a](https://github.com/microsoft/OpenAPI.NET/commit/4db5c1ae39d4bc6c5138fda5d9d14904f069fa3e))

## 2.0.0-preview.25

## [2.0.0-preview.25](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.24...v2.0.0-preview.25) (2025-06-10)


### Bug Fixes

* ci configuration ([e7f76f7](https://github.com/microsoft/OpenAPI.NET/commit/e7f76f753649d5747a720b55babe2c59bbedfd49))
* ci configuration ([a8fd917](https://github.com/microsoft/OpenAPI.NET/commit/a8fd91728bc57102d36bfdb6442e3c273b2818e6))

## 2.0.0-preview.24

## [2.0.0-preview.24](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.23...v2.0.0-preview.24) (2025-06-09)


### Bug Fixes

* callback reference annotations parsing ([86892b3](https://github.com/microsoft/OpenAPI.NET/commit/86892b361c7dcbe445ddfe10fd57fd9ab2d8a5a9))
* example reference annotation parsing ([8bf012b](https://github.com/microsoft/OpenAPI.NET/commit/8bf012b7d576f5efd6d0953859b98494958c2c4e))
* link reference annotations parsing ([2a62c5a](https://github.com/microsoft/OpenAPI.NET/commit/2a62c5a2874d935aba09c1995d022988ac793609))
* loading of header reference description ([9248560](https://github.com/microsoft/OpenAPI.NET/commit/9248560d0bac2c3e2d635b653a26d4bfa14e51f4))
* makes reference serialization object generic ([f0802e5](https://github.com/microsoft/OpenAPI.NET/commit/f0802e5cb1974b6b2d4dc7100b2e3f808ab3538b))
* parameter reference annoation parsing ([b1578f3](https://github.com/microsoft/OpenAPI.NET/commit/b1578f3fdc8bdbdeab3063ae3d3e6a554800f6d6))
* path item reference annoations parsing ([d31ed4c](https://github.com/microsoft/OpenAPI.NET/commit/d31ed4c9e0a095eb247de450b3122f0b1dd675d6))
* removes description field from references that do not support it ([03659f7](https://github.com/microsoft/OpenAPI.NET/commit/03659f7d055e6b339e15ac4434ae4037abb3a546))
* request body reference annotations parsing ([d9a78dc](https://github.com/microsoft/OpenAPI.NET/commit/d9a78dc5e5433d0f1b628569f4124d4de575cba1))
* response reference annotations parsing ([e455f52](https://github.com/microsoft/OpenAPI.NET/commit/e455f52f30fdb4937c27132b9596f89f17997663))
* security scheme reference annoations parsing ([ccc3733](https://github.com/microsoft/OpenAPI.NET/commit/ccc3733a2700d087aac289bb31a6107e9e6d743f))

## 2.0.0-preview.23

## [2.0.0-preview.23](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.22...v2.0.0-preview.23) (2025-06-03)


### Features

* upgrades OData lib in Hidi to preview15 ([540240a](https://github.com/microsoft/OpenAPI.NET/commit/540240aba9f96b598459cd49b67cd02adc82713d))
* upgrades OData lib to preview15 ([b300265](https://github.com/microsoft/OpenAPI.NET/commit/b3002652805ff2a36e55531178d4fe579b196c56))

## 2.0.0-preview.22

## [2.0.0-preview....

_Description has been truncated_

[dependabot]

Labels

The following labels could not be found: backend, dependencies. Please create them before Dependabot can add them to a pull request.

Please fix the above issues or remove invalid values from dependabot.yml.

[AndreaPrestia]

@dependabot rebase

[AndreaPrestia]

Chiudo: Microsoft.OpenApi 3.x rimuove il namespace 'Microsoft.OpenApi.Models' usato in Program.cs (OpenApiInfo, OpenApiSecurityScheme, ecc.). Swashbuckle.AspNetCore 7.2.0 non e' ancora compatibile con OpenApi 3.x (dipende ancora dalla 1.x transitivamente). Bump prematuro finche' non usciamo Swashbuckle 8 con supporto OpenApi 3, oppure valutiamo la migrazione a Microsoft.AspNetCore.OpenApi (builtin .NET 9+).

[dependabot]

OK, I won't notify you again about this release, but will get in touch when a new version is available. If you'd rather skip all updates until the next major or minor version, let me know by commenting @dependabot ignore this major version or @dependabot ignore this minor version. You can also ignore all major, minor, or patch releases for a dependency by adding an ignore condition with the desired update_types to your config file.

If you change your mind, just re-open this PR and I'll resolve any conflicts on it.