Skip to content

Conversation

dependabot[bot]
Copy link
Contributor

@dependabot dependabot bot commented on behalf of github Aug 20, 2025

Updated Microsoft.OpenApi from 1.6.24 to 2.1.0.

Release notes

Sourced from Microsoft.OpenApi's releases.

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

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.22](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.21...v2.0.0-preview.22) (2025-06-02)


### Features

* Add writer settings to enable collection sorting using a comparer ([d7eaf47](https://github.com/microsoft/OpenAPI.NET/commit/d7eaf4707c26351cff4e4ec798b64967d9dd932f))


### Bug Fixes

* rename class; add logic for sorting IEnumerable collections ([58cb4ac](https://github.com/microsoft/OpenAPI.NET/commit/58cb4ac718a840a8dfb5c8821a3c0a484c29befd))

## 2.0.0-preview.21

## [2.0.0-preview.21](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.20...v2.0.0-preview.21) (2025-05-21)


### Bug Fixes

* do not throw when operation tag is missing matching global tag ([fe133f2](https://github.com/microsoft/OpenAPI.NET/commit/fe133f2604e9b65cc1c7011aab7c62f44e649d19))
* do not throw when operation tag is missing matching global tag ([2c5aa40](https://github.com/microsoft/OpenAPI.NET/commit/2c5aa40cbb8bf1e96c1ccce6273579e70b69ade2))

## 2.0.0-preview.20

## [2.0.0-preview.20](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.19...v2.0.0-preview.20) (2025-05-20)


### Bug Fixes

* nullable and type ordering should be maintain to ease up migration work ([6c82aa6](https://github.com/microsoft/OpenAPI.NET/commit/6c82aa6b2d6e4f39af3c594edd8590a0cf749530))
* nullable should not be inserted as an attempt to normalize the document ([6c82aa6](https://github.com/microsoft/OpenAPI.NET/commit/6c82aa6b2d6e4f39af3c594edd8590a0cf749530))
* refactor to avoid adding duplicate entries ([41fd508](https://github.com/microsoft/OpenAPI.NET/commit/41fd508074f1b70415026df3aa878cd5f5e7b1ee))
* refactor to avoid adding duplicate entries ([#​2359](https://github.com/microsoft/OpenAPI.NET/issues/2359)) ([9791eb6](https://github.com/microsoft/OpenAPI.NET/commit/9791eb684a0f040feeb8c58701fd4f3577e73e2c))
* tree node has the wrong structure because of trailing slashes ([2ffb273](https://github.com/microsoft/OpenAPI.NET/commit/2ffb2735aa3718370d6094186142f9cf50b194fa))
* tree node has the wrong structure because of trailing slashes ([4439340](https://github.com/microsoft/OpenAPI.NET/commit/443934060e1e446de726addde69a2de955b95a7b))
* wrong link to json schema spec in schema doc comments ([d9b0c90](https://github.com/microsoft/OpenAPI.NET/commit/d9b0c906f7173b81fea15001d588edcbc3eed8f1))
* wrong link to json schema spec in schema doc comments ([9a73ec6](https://github.com/microsoft/OpenAPI.NET/commit/9a73ec6e5486d84b6a30a5fa0ac5961b381fc3d3))

## 2.0.0-preview.19

## [2.0.0-preview.19](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.18...v2.0.0-preview.19) (2025-05-16)


### Bug Fixes

* base url should be read from the settings when available ([f5d6e81](https://github.com/microsoft/OpenAPI.NET/commit/f5d6e81c21fd18b6de0fb19b535ad6dbc187790d))
* base url should be read from the settings when available ([b17b7d8](https://github.com/microsoft/OpenAPI.NET/commit/b17b7d8d25fdf9a767411481287aacee31434aaa))
* discriminator mapping references don't get a document when created from DOM ([767d3fb](https://github.com/microsoft/OpenAPI.NET/commit/767d3fb163b273b275cd67d710c573c59e4e642b))
* discriminator mapping references don't get a document when created from DOM ([fdfe002](https://github.com/microsoft/OpenAPI.NET/commit/fdfe002d551fc3feaaeb5af24042826f13bdf412))

## 2.0.0-preview.18

## [2.0.0-preview.18](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.17...v2.0.0-preview.18) (2025-05-13)


### Features

* upgrades openapi.net.odata and apimanifest to the latest version ([80844a6](https://github.com/microsoft/OpenAPI.NET/commit/80844a60ae50ba0a4d54d7dd2e45ce8360206bf5))
* upgrades openapi.net.odata and apimanifest to the latest version ([938a2e0](https://github.com/microsoft/OpenAPI.NET/commit/938a2e07b40b082e01ed1cdf3244767cbdca4061))


### Bug Fixes

* avoid calling virtual members in constructor ([5835057](https://github.com/microsoft/OpenAPI.NET/commit/5835057a7e905e371f859e727ddaf65ec08c6db0))
* Fix typo in error message ([#​2345](https://github.com/microsoft/OpenAPI.NET/issues/2345)) ([3f8b2b9](https://github.com/microsoft/OpenAPI.NET/commit/3f8b2b99c07bd3c58825728c2dd2ffed91d88fbe))
* handle deserializing and writing empty security requirements [#​1426](https://github.com/microsoft/OpenAPI.NET/issues/1426) ([#​2323](https://github.com/microsoft/OpenAPI.NET/issues/2323)) ([962e0e4](https://github.com/microsoft/OpenAPI.NET/commit/962e0e436f96b1b68613013d75307dc1f92ce15c))
* normalized override implementation for parameter types serialization in v2 ([5930916](https://github.com/microsoft/OpenAPI.NET/commit/593091621926defcbc2727a922613e34557d882a))

## 2.0.0-preview.17

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


### Features

* discriminator mappings now use schema references ([b4877f6](https://github.com/microsoft/OpenAPI.NET/commit/b4877f674ad1a240a367390d40d122eebccc0b20))
* openapiformat enum cleanup ([#​2326](https://github.com/microsoft/OpenAPI.NET/issues/2326)) ([19ffd13](https://github.com/microsoft/OpenAPI.NET/commit/19ffd136a7d2137f3de0896148d9a39f469ac711))
* Remove default collection initialization for perf reasons ([#​2284](https://github.com/microsoft/OpenAPI.NET/issues/2284)) ([3604382](https://github.com/microsoft/OpenAPI.NET/commit/36043829d29340a47fc93c6477a38ea93e59ef57))


### Bug Fixes

* Empty tag causes error generating Kiota client [#​2283](https://github.com/microsoft/OpenAPI.NET/issues/2283) ([#​2286](https://github.com/microsoft/OpenAPI.NET/issues/2286)) ([521d636](https://github.com/microsoft/OpenAPI.NET/commit/521d636e2c437c25e1758e9f6a22793d74adf2d7))
* hidi fails to parse yaml files when fixing references ([a5c4d61](https://github.com/microsoft/OpenAPI.NET/commit/a5c4d6109c433b949cdb1665c00ad778b82b28b0))
* hidi fails to parse yaml files when fixing references ([c5b69fe](https://github.com/microsoft/OpenAPI.NET/commit/c5b69fed9c413a6399c36e0f543e1019faac77e6))
* Improve handling of OpenAPI tag references ([#​2325](https://github.com/microsoft/OpenAPI.NET/issues/2325)) ([bf9954a](https://github.com/microsoft/OpenAPI.NET/commit/bf9954a257691231fac6f56667bde208a98a5b42))
* read (Exclusive)Maximum and (Exclusive)Minimum values as strings and write their raw values during serialization ([#​2309](https://github.com/microsoft/OpenAPI.NET/issues/2309)) ([ac66756](https://github.com/microsoft/OpenAPI.NET/commit/ac667560a951bef2824851c208c55ba070e96163))
* relative references in subdirectory documents are not loading [#​1674](https://github.com/microsoft/OpenAPI.NET/issues/1674) ([#​2243](https://github.com/microsoft/OpenAPI.NET/issues/2243)) ([4bcbd51](https://github.com/microsoft/OpenAPI.NET/commit/4bcbd51caff689a73e90efbc08f683383741e004))
* renames annotations schema property to metadata to match [#​2241](https://github.com/microsoft/OpenAPI.NET/issues/2241) ([28e4a75](https://github.com/microsoft/OpenAPI.NET/commit/28e4a7590fb3525e30970112191d72eaf048ad6b))
* renames annotations schema property to metadata to match [#​2241](https://github.com/microsoft/OpenAPI.NET/issues/2241) ([33fc7cb](https://github.com/microsoft/OpenAPI.NET/commit/33fc7cbcda71efea47070ab7a6ebf9db8787a7f8))
* set format to binary for file uploads ([#​2305](https://github.com/microsoft/OpenAPI.NET/issues/2305)) ([47f10d3](https://github.com/microsoft/OpenAPI.NET/commit/47f10d323e78b9e6caa757c0d2efa378a19fc28c))

## 2.0.0-preview.16

## [2.0.0-preview.16](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.15...v2.0.0-preview.16) (2025-03-20)


### Bug Fixes

* always serialize security schemes in components ([3aac661](https://github.com/microsoft/OpenAPI.NET/commit/3aac661ca2e8050136c423f2835fcdd3a9096482))
* always serialize security schemes in components ([a765acf](https://github.com/microsoft/OpenAPI.NET/commit/a765acf380135694bbd4d1336bd4beddef6ef808))

## 2.0.0-preview.15

## [2.0.0-preview.15](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.14...v2.0.0-preview.15) (2025-03-18)


### Bug Fixes

* Include hidi in solution ([7f4bec8](https://github.com/microsoft/OpenAPI.NET/commit/7f4bec8304771b498e8b0e33c706869ff79fd155))
* remove duplicate unused property ([f62e039](https://github.com/microsoft/OpenAPI.NET/commit/f62e039a2efde04d0c3988b359ca09ab3349a40b))
* revert change to exclude hidi in solution ([c3afe4e](https://github.com/microsoft/OpenAPI.NET/commit/c3afe4e8af2526e957940503a31079ed5f027c0a))

## 2.0.0-preview.14

## [2.0.0-preview.14](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.13...v2.0.0-preview.14) (2025-03-18)


### Bug Fixes

* exclude hidi from release due to package source mapping conflict ([72daa54](https://github.com/microsoft/OpenAPI.NET/commit/72daa544f2bfe8d51ed69d7ba82d31cbc36580f2))

## 2.0.0-preview.13

## [2.0.0-preview.13](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.12...v2.0.0-preview.13) (2025-03-14)


### Features

* adds OpenApiDocument.SerializeAs() so simplify serialization scenarios ([371a574](https://github.com/microsoft/OpenAPI.NET/commit/371a57405b013bdc257a51cc831f7487d1749823))
* enable null reference type support ([#​2146](https://github.com/microsoft/OpenAPI.NET/issues/2146)) ([96574ec](https://github.com/microsoft/OpenAPI.NET/commit/96574ecc46dca647a708b6673c7e5309824eda2f))
* enables references as components ([eeffba9](https://github.com/microsoft/OpenAPI.NET/commit/eeffba9d50a53a3be1630d01edd8d0b57a966dee))
* use http method object instead of enum ([8baff28](https://github.com/microsoft/OpenAPI.NET/commit/8baff287aa9450ad3bd467816de321e30157bcb3))


### Bug Fixes

* a bug where references would not serialize summary or descriptions in 3.1 ([ca7ccdd](https://github.com/microsoft/OpenAPI.NET/commit/ca7ccdd933b57c2775d0295e22e541c2904b5fb7))
* handling for reference IDs with http prefix ([3385a0e](https://github.com/microsoft/OpenAPI.NET/commit/3385a0e0088c44fb926affcb20f166a02391427c))

## 2.0.0-preview.12

## [2.0.0-preview.12](https://github.com/microsoft/OpenAPI.NET/compare/v2.0.0-preview.11...v2.0.0-preview.12) (2025-03-07)


### Bug Fixes

* fixes serialization of openApidocs with operation tags with settings to inline references ([8eecae6](https://github.com/microsoft/OpenAPI.NET/commit/8eecae6183f594c5508fc2c74d395c6030ce8727))
* fixes serialization of openApidocs with operation tags with settings to inline references. ([f67fe64](https://github.com/microsoft/OpenAPI.NET/commit/f67fe64e669a3f8518d89b007150c3e1bdb69fd1))

## 2.0.0-preview.11

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


### Bug Fixes

* rename `OpenApiDocument.SecurityRequirements` as `Security` ([d8553d6](https://github.com/microsoft/OpenAPI.NET/commit/d8553d6e007c1fa38bb982c9eb757678e789111b))


### Miscellaneous Chores

* release 2.0.0-preview.11 ([f425b8e](https://github.com/microsoft/OpenAPI.NET/commit/f425b8ed48ce5e488f85ad3060e6c43734274250))

Commits viewable in [compare view](https://github.com/Microsoft/OpenAPI.NET/compare/v1.6.24...v2.1.0).
</details>

[![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=Microsoft.OpenApi&package-manager=nuget&previous-version=1.6.24&new-version=2.1.0)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting `@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
- `@dependabot show <dependency name> ignore conditions` will show all of the ignore conditions of the specified dependency
- `@dependabot ignore <dependency name> major version` will close this group update PR and stop Dependabot creating any more for the specific dependency's major version (unless you unignore this specific dependency's major version or upgrade to it yourself)
- `@dependabot ignore <dependency name> minor version` will close this group update PR and stop Dependabot creating any more for the specific dependency's minor version (unless you unignore this specific dependency's minor version or upgrade to it yourself)
- `@dependabot ignore <dependency name>` will close this group update PR and stop Dependabot creating any more for the specific dependency (unless you unignore this specific dependency or upgrade to it yourself)
- `@dependabot unignore <dependency name>` will remove all of the ignore conditions of the specified dependency
- `@dependabot unignore <dependency name> <ignore condition>` will remove the ignore condition of the specified dependency and ignore conditions


</details>

Bumps Microsoft.OpenApi from 1.6.24 to 2.1.0

---
updated-dependencies:
- dependency-name: Microsoft.OpenApi
  dependency-version: 2.1.0
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: microsoft-openapi
...

Signed-off-by: dependabot[bot] <[email protected]>
@dependabot dependabot bot added .NET Pull requests that update .NET code dependencies Pull requests that update a dependency file labels Aug 20, 2025
@dependabot dependabot bot requested a review from martincostello as a code owner August 20, 2025 17:55
@dependabot dependabot bot added dependencies Pull requests that update a dependency file .NET Pull requests that update .NET code labels Aug 20, 2025
Copy link
Contributor

@costellobot costellobot bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Auto-approving dependency update.

@costellobot costellobot bot enabled auto-merge (squash) August 20, 2025 17:55
auto-merge was automatically disabled August 20, 2025 17:59

Pull request was closed

Copy link
Contributor Author

dependabot bot commented on behalf of github Aug 20, 2025

This pull request was built based on a group rule. Closing it will not ignore any of these versions in future pull requests.

To ignore these dependencies, configure ignore rules in dependabot.yml

@martincostello martincostello deleted the dependabot/nuget/src/TodoApp/microsoft-openapi-4f1c657448 branch August 20, 2025 17:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
dependencies Pull requests that update a dependency file .NET Pull requests that update .NET code
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant