reference the relevant section of the spec in definitions
MODIFY
schemas/v3.1/schema.json
schemas/v3.1/schema.json
"unevaluatedProperties": false,
"$defs": {
"info": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#info-object",
"type": "object",
"properties": {
"title": {
"unevaluatedProperties": false
},
"contact": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#contact-object",
"type": "object",
"properties": {
"name": {
"unevaluatedProperties": false
},
"license": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#license-object",
"type": "object",
"properties": {
"name": {
"unevaluatedProperties": false
},
"server": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#server-object",
"type": "object",
"properties": {
"url": {
"unevaluatedProperties": false
},
"server-variable": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#server-variable-object",
"type": "object",
"properties": {
"enum": {
"unevaluatedProperties": false
},
"components": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#components-object",
"type": "object",
"properties": {
"schemas": {
"unevaluatedProperties": false
},
"paths": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#paths-object",
"type": "object",
"patternProperties": {
"^/": {
"unevaluatedProperties": false
},
"path-item": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#path-item-object",
"type": "object",
"properties": {
"summary": {
}
},
"operation": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#operation-object",
"type": "object",
"properties": {
"tags": {
"unevaluatedProperties": false
},
"external-documentation": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#external-documentation-object",
"type": "object",
"properties": {
"description": {
"unevaluatedProperties": false
},
"parameter": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#parameter-object",
"type": "object",
"properties": {
"name": {
}
},
"request-body": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#request-body-object",
"type": "object",
"properties": {
"description": {
}
},
"content": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#fixed-fields-10",
"type": "object",
"additionalProperties": {
"$ref": "#/$defs/media-type"
}
},
"media-type": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#media-type-object",
"type": "object",
"properties": {
"schema": {
"unevaluatedProperties": false
},
"encoding": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#encoding-object",
"type": "object",
"properties": {
"contentType": {
}
},
"responses": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#responses-object",
"type": "object",
"properties": {
"default": {
"unevaluatedProperties": false
},
"response": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#response-object",
"type": "object",
"properties": {
"description": {
}
},
"callbacks": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#callback-object",
"type": "object",
"$ref": "#/$defs/specification-extensions",
"additionalProperties": {
}
},
"example": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#example-object",
"type": "object",
"properties": {
"summary": {
}
},
"link": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#link-object",
"type": "object",
"properties": {
"operationRef": {
}
},
"header": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#header-object",
"type": "object",
"properties": {
"description": {
}
},
"tag": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#tag-object",
"type": "object",
"properties": {
"name": {
"unevaluatedProperties": false
},
"reference": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#reference-object",
"type": "object",
"properties": {
"$ref": {
"unevaluatedProperties": false
},
"schema": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#schema-object",
"$dynamicAnchor": "meta",
"type": [
"object",
]
},
"security-scheme": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#security-scheme-object",
"type": "object",
"properties": {
"type": {
}
},
"security-requirement": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#security-requirement-object",
"type": "object",
"additionalProperties": {
"type": "array",
}
},
"specification-extensions": {
+ "$comment": "https://spec.openapis.org/oas/v3.1.0#specification-extensions",
"patternProperties": {
"^x-": true
}

MODIFY
schemas/v3.1/schema.yaml
schemas/v3.1/schema.yaml
@@ -49,6 +49,7 @@ unevaluatedProperties: false
$defs:
info:
+ $comment: https://spec.openapis.org/oas/v3.1.0#info-object
type: object
properties:
title:
@@ -72,6 +73,7 @@ $defs:
unevaluatedProperties: false
contact:
+ $comment: https://spec.openapis.org/oas/v3.1.0#contact-object
type: object
properties:
name:
@@ -84,6 +86,7 @@ $defs:
unevaluatedProperties: false
license:
+ $comment: https://spec.openapis.org/oas/v3.1.0#license-object
type: object
properties:
name:
@@ -104,6 +107,7 @@ $defs:
unevaluatedProperties: false
server:
+ $comment: https://spec.openapis.org/oas/v3.1.0#server-object
type: object
properties:
url:
@@ -121,6 +125,7 @@ $defs:
unevaluatedProperties: false
server-variable:
+ $comment: https://spec.openapis.org/oas/v3.1.0#server-variable-object
type: object
properties:
enum:
@@ -138,6 +143,7 @@ $defs:
unevaluatedProperties: false
components:
+ $comment: https://spec.openapis.org/oas/v3.1.0#components-object
type: object
properties:
schemas:
@@ -189,6 +195,7 @@ $defs:
unevaluatedProperties: false
paths:
+ $comment: https://spec.openapis.org/oas/v3.1.0#paths-object
type: object
patternProperties:
'^/':
@@ -197,6 +204,7 @@ $defs:
unevaluatedProperties: false
path-item:
+ $comment: https://spec.openapis.org/oas/v3.1.0#path-item-object
type: object
properties:
summary:
@@ -228,6 +236,7 @@ $defs:
$ref: '#/$defs/path-item'
operation:
+ $comment: https://spec.openapis.org/oas/v3.1.0#operation-object
type: object
properties:
tags:
@@ -269,6 +278,7 @@ $defs:
unevaluatedProperties: false
external-documentation:
+ $comment: https://spec.openapis.org/oas/v3.1.0#external-documentation-object
type: object
properties:
description:
@@ -282,6 +292,7 @@ $defs:
unevaluatedProperties: false
parameter:
+ $comment: https://spec.openapis.org/oas/v3.1.0#parameter-object
type: object
properties:
name:
@@ -431,6 +442,7 @@ $defs:
$ref: '#/$defs/parameter'
request-body:
+ $comment: https://spec.openapis.org/oas/v3.1.0#request-body-object
type: object
properties:
description:
@@ -456,6 +468,7 @@ $defs:
$ref: '#/$defs/request-body'
content:
+ $comment: https://spec.openapis.org/oas/v3.1.0#fixed-fields-10
type: object
additionalProperties:
$ref: '#/$defs/media-type'
@@ -463,6 +476,7 @@ $defs:
format: media-range
media-type:
+ $comment: https://spec.openapis.org/oas/v3.1.0#media-type-object
type: object
properties:
schema:
@@ -477,6 +491,7 @@ $defs:
unevaluatedProperties: false
encoding:
+ $comment: https://spec.openapis.org/oas/v3.1.0#encoding-object
type: object
properties:
contentType:
@@ -521,6 +536,7 @@ $defs:
default: false
responses:
+ $comment: https://spec.openapis.org/oas/v3.1.0#responses-object
type: object
properties:
default:
@@ -532,6 +548,7 @@ $defs:
unevaluatedProperties: false
response:
+ $comment: https://spec.openapis.org/oas/v3.1.0#response-object
type: object
properties:
description:
@@ -562,6 +579,7 @@ $defs:
$ref: '#/$defs/response'
callbacks:
+ $comment: https://spec.openapis.org/oas/v3.1.0#callback-object
type: object
$ref: '#/$defs/specification-extensions'
additionalProperties:
@@ -578,6 +596,7 @@ $defs:
$ref: '#/$defs/callbacks'
example:
+ $comment: https://spec.openapis.org/oas/v3.1.0#example-object
type: object
properties:
summary:
@@ -602,6 +621,7 @@ $defs:
$ref: '#/$defs/example'
link:
+ $comment: https://spec.openapis.org/oas/v3.1.0#link-object
type: object
properties:
operationRef:
@@ -634,6 +654,7 @@ $defs:
$ref: '#/$defs/link'
header:
+ $comment: https://spec.openapis.org/oas/v3.1.0#header-object
type: object
properties:
description:
@@ -679,6 +700,7 @@ $defs:
$ref: '#/$defs/header'
tag:
+ $comment: https://spec.openapis.org/oas/v3.1.0#tag-object
type: object
properties:
name:
@@ -693,6 +715,7 @@ $defs:
unevaluatedProperties: false
reference:
+ $comment: https://spec.openapis.org/oas/v3.1.0#reference-object
type: object
properties:
$ref:
@@ -705,12 +728,14 @@ $defs:
unevaluatedProperties: false
schema:
+ $comment: https://spec.openapis.org/oas/v3.1.0#schema-object
$dynamicAnchor: meta
type:
- object
- boolean
security-scheme:
+ $comment: https://spec.openapis.org/oas/v3.1.0#security-scheme-object
type: object
properties:
type:
@@ -902,6 +927,7 @@ $defs:
unevaluatedProperties: false
security-requirement:
+ $comment: https://spec.openapis.org/oas/v3.1.0#security-requirement-object
type: object
additionalProperties:
type: array
@@ -909,6 +935,7 @@ $defs:
type: string
specification-extensions:
+ $comment: https://spec.openapis.org/oas/v3.1.0#specification-extensions
patternProperties:
'^x-': true

reference the relevant section of the spec in definitions (#2792)