update to OpenAPI 3.1.x

[deanurce]

Im trying to upgrade to openapi 3.1.0 to be able to use type: mutualTLS in the security scheme definition, and it throws an error that the version is not recognised.
Since the 3.1.0 upgrade has been around for quite some time, will it be supported anytime soon?

Screenshot of error below.

[dbanty]

Actually supporting the features of 3.1.0 is probably a long way off since there are still 3.0 features incomplete 😬.

Reading the spec and just handling any breaking changes for the 3.0 features we do support is probably relatively easy, just a time investment.

I'm unlikely to have the time to do that anytime soon, but would welcome a PR from someone who does.

[philsturgeon]

The changes are not too major, just moving in line with JSON Schema for the schema objects and a few simplifications to examples. https://www.openapis.org/blog/2021/02/16/migrating-from-openapi-3-0-to-3-1-0