OAI/OpenAPI-Specification 3.1.0-rc1

OAS 3.1.0-rc1 Released!

on GitHub

Changelog

See 3.1.0-rc0 for previous changes in 3.1.0, including the explanation of why there are breaking changes.

Breaking changes

• Server Variable's enum now MUST not be empty (changed from SHOULD).
• Server Variable's default now MUST exist in the enum values, if such values are defined (changed from SHOULD).
• responses are no longer required to be defined under the Operation Object.

Clarifications

• It is now clarified when path template expression may not have a corresponding path parameter.
• Data types (and just primitive data types) now correspond to JSON Schema.
• Various cosmetic fixes.
• A new section was added to address how to handle the $schema keyword (implicitly and explicitly).