Schema objects are sometimes referred to as models, data types, or simply, schemas. This is because schema types are used to model complex data types used by an API.
A discriminator object describes how to differentiate between related schemas based on the value of a field in a request or response. See Composition and Inheritance.
A discriminator object describes how to differentiate between related schemas based on the value of a field in a request or response. See Composition and Inheritance.
Any number of extension fields can be added to the schema that can be used by tooling and vendors.
Arbitrary properties
Any
The schema object supports arbitrary properties without the
prefix. This is discouraged in favor of Extensions.
The example below illustrates three schema objects: IngredientProductCode, Ingredient, and IngredientType.
JSON Schema and OpenAPI
OpenAPI 3.0 was not totally compatible with JSON schema. That caused, and continues to cause, issues in tooling support. Fortunately, OpenAPI 3.1 is now a superset of JSON Schema, meaning compatibility with any valid JSon Schema document.