Skip to content

OAS 3.1.0-rc1 Released!

Pre-release
Pre-release
Compare
Choose a tag to compare
@webron webron released this 09 Oct 01:31
f8449d1

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).