Skip to content

Clarify the relationship between OpenAPI 3.1 and the JSON Schema version #2363

Closed
@darrelmiller

Description

@darrelmiller

The current 3.1 spec says,

The Schema Object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. This object is a superset of the JSON Schema Specification Draft 2019-09.

We should agree on wording to clarify that future versions of JSON Schema (assuming non-breaking) are also usable with OpenAPI 3.1. (wordsmithing required)

In order to achieve forward compatibility with JSON Schema, we need to define the OpenAPI keywords as a vocabulary. And define how the OpenAPI vocabulary is applied to the JSON.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions