apiDefinition.swagger.schema.json

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "id": "http://swagger.io/v2/schema.json#",
  "title": "A JSON Schema for Swagger 2.0 API.",
  "type": "object",
  "required": [
    "swagger",
    "info",
    "paths"
  ],
  "additionalProperties": false,
  "patternProperties": {
    "^x-(?!ms-)": {
      "$ref": "#/definitions/vendorExtension"
    }
  },
  "properties": {
    "swagger": {
      "type": "string",
      "enum": [
        "2.0"
      ],
      "description": "The Swagger version of this document."
    },
    "info": {
      "$ref": "#/definitions/info"
    },
    "host": {
      "type": "string",
      "pattern": "^[^{}/ :\\\\]+(?::\\d+)?$",
      "description": "The host (name or ip) of the API. Example: 'swagger.io'"
    },
    "basePath": {
      "type": "string",
      "pattern": "^/",
      "description": "The base path to the API. Example: '/api'."
    },
    "schemes": {
      "$ref": "#/definitions/schemesList"
    },
    "consumes": {
      "description": "A list of MIME types accepted by the API.",
      "allOf": [
        {
          "$ref": "#/definitions/mediaTypeList"
        }
      ]
    },
    "produces": {
      "description": "A list of MIME types the API can produce.",
      "allOf": [
        {
          "$ref": "#/definitions/mediaTypeList"
        }
      ]
    },
    "paths": {
      "$ref": "#/definitions/paths"
    },
    "definitions": {
      "$ref": "#/definitions/definitions"
    },
    "parameters": {
      "$ref": "#/definitions/parameterDefinitions"
    },
    "responses": {
      "$ref": "#/definitions/responseDefinitions"
    },
    "security": {
      "$ref": "#/definitions/security"
    },
    "securityDefinitions": {
      "$ref": "#/definitions/securityDefinitions"
    },
    "tags": {
      "type": "array",
      "items": {
        "$ref": "#/definitions/tag"
      },
      "uniqueItems": true
    },
    "externalDocs": {
      "$ref": "#/definitions/externalDocs"
    },
    "x-ms-capabilities": {
      "$ref": "#/definitions/x-ms-capabilities<api>"
    },
    "x-ms-connector-metadata": {
      "$ref": "#/definitions/x-ms-connector-metadata"
    },
    "x-ms-docs": {
      "$ref": "#/definitions/x-ms-docs"
    }
  },
  "definitions": {
    "$ref": {
      "description": "Swagger $ref's should only point to objects immediatly under #/definitions, #/parameters, and #/responses.",
      "type": "string",
      "defaultSnippets": [
        {
          "body": "#/definitions/$0"
        },
        {
          "body": "#/parameters/$0"
        },
        {
          "body": "#/responses/$0"
        }
      ]
    },
    "info": {
      "type": "object",
      "description": "General information about the API.",
      "required": [
        "version",
        "title"
      ],
      "additionalProperties": false,
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      },
      "properties": {
        "title": {
          "type": "string",
          "description": "A unique and precise title of the API."
        },
        "version": {
          "type": "string",
          "description": "A semantic version number of the API."
        },
        "description": {
          "type": "string",
          "description": "A longer description of the API. Should be different from the title.  GitHub Flavored Markdown is allowed."
        },
        "termsOfService": {
          "type": "string",
          "description": "The terms of service for the API."
        },
        "contact": {
          "$ref": "#/definitions/contact"
        },
        "license": {
          "$ref": "#/definitions/license"
        },
        "x-ms-deployment-version": {
          "$ref": "#/definitions/x-ms-deployment-version"
        },
        "x-ms-api-annotation": {
          "$ref": "#/definitions/x-ms-api-annotation<info>"
        }
      }
    },
    "contact": {
      "type": "object",
      "description": "Contact information for the owners of the API.",
      "additionalProperties": false,
      "properties": {
        "name": {
          "type": "string",
          "description": "The identifying name of the contact person/organization."
        },
        "url": {
          "type": "string",
          "description": "The URL pointing to the contact information.",
          "format": "uri"
        },
        "email": {
          "type": "string",
          "description": "The email address of the contact person/organization.",
          "format": "email"
        }
      },
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      }
    },
    "license": {
      "type": "object",
      "required": [
        "name"
      ],
      "additionalProperties": false,
      "properties": {
        "name": {
          "type": "string",
          "description": "The name of the license type. It's encouraged to use an OSI compatible license."
        },
        "url": {
          "type": "string",
          "description": "The URL pointing to the license.",
          "format": "uri"
        }
      },
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      }
    },
    "paths": {
      "type": "object",
      "description": "Relative paths to the individual endpoints. They must be relative to the 'basePath'.",
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        },
        "^/": {
          "$ref": "#/definitions/pathItem"
        }
      },
      "additionalProperties": false
    },
    "definitions": {
      "type": "object",
      "additionalProperties": {
        "$ref": "#/definitions/schema-dynamic-allowed"
      },
      "description": "One or more JSON objects describing the schemas being consumed and produced by the API."
    },
    "parameterDefinitions": {
      "type": "object",
      "additionalProperties": {
        "$ref": "#/definitions/parameter"
      },
      "description": "One or more JSON representations for parameters"
    },
    "responseDefinitions": {
      "type": "object",
      "additionalProperties": {
        "$ref": "#/definitions/response"
      },
      "description": "One or more JSON representations for responses"
    },
    "externalDocs": {
      "type": "object",
      "additionalProperties": false,
      "description": "information about external documentation",
      "required": [
        "url"
      ],
      "properties": {
        "description": {
          "type": "string"
        },
        "url": {
          "type": "string",
          "format": "uri"
        }
      },
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      }
    },
    "examples": {
      "type": "object",
      "additionalProperties": true
    },
    "mimeType": {
      "type": "string",
      "description": "The MIME type of the HTTP message."
    },
    "operation": {
      "type": "object",
      "required": [
        "responses"
      ],
      "additionalProperties": false,
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      },
      "properties": {
        "tags": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "uniqueItems": true
        },
        "summary": {
          "type": "string",
          "description": "A brief summary of the operation."
        },
        "description": {
          "type": "string",
          "description": "A longer description of the operation, GitHub Flavored Markdown is allowed."
        },
        "externalDocs": {
          "$ref": "#/definitions/externalDocs"
        },
        "operationId": {
          "type": "string",
          "description": "A unique identifier of the operation."
        },
        "produces": {
          "description": "A list of MIME types the API can produce.",
          "allOf": [
            {
              "$ref": "#/definitions/mediaTypeList"
            }
          ]
        },
        "consumes": {
          "description": "A list of MIME types the API can consume.",
          "allOf": [
            {
              "$ref": "#/definitions/mediaTypeList"
            }
          ]
        },
        "parameters": {
          "$ref": "#/definitions/parametersList"
        },
        "responses": {
          "$ref": "#/definitions/responses"
        },
        "schemes": {
          "$ref": "#/definitions/schemesList"
        },
        "deprecated": {
          "type": "boolean",
          "default": false
        },
        "security": {
          "$ref": "#/definitions/security"
        },
        "x-ms-api-annotation": {
          "$ref": "#/definitions/x-ms-api-annotation<operation>"
        },
        "x-ms-capabilities": {
          "$ref": "#/definitions/x-ms-capabilities<operation>"
        },
        "x-ms-no-generic-test": {
          "$ref": "#/definitions/x-ms-no-generic-test"
        },
        "x-ms-operation-context": {
          "$ref": "#/definitions/x-ms-operation-context"
        },
        "x-ms-pageable": {
          "$ref": "#/definitions/x-ms-pageable"
        },
        "x-ms-safe-operation": {
          "$ref": "#/definitions/x-ms-safe-operation"
        },
        "x-ms-summary": {
          "$ref": "#/definitions/x-ms-summary"
        },
        "x-ms-trigger": {
          "$ref": "#/definitions/x-ms-trigger"
        },
        "x-ms-trigger-hint": {
          "$ref": "#/definitions/x-ms-trigger-hint"
        },
        "x-ms-trigger-metadata": {
          "$ref": "#/definitions/x-ms-trigger-metadata"
        },
        "x-ms-notification": {
          "$ref": "#/definitions/x-ms-notification"
        },
        "x-ms-visibility": {
          "$ref": "#/definitions/x-ms-visibility"
        }
      }
    },
    "pathItem": {
      "type": "object",
      "additionalProperties": false,
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      },
      "properties": {
        "$ref": {
          "$ref": "#/definitions/$ref"
        },
        "get": {
          "$ref": "#/definitions/operation"
        },
        "put": {
          "$ref": "#/definitions/operation"
        },
        "post": {
          "$ref": "#/definitions/operation"
        },
        "delete": {
          "$ref": "#/definitions/operation"
        },
        "options": {
          "$ref": "#/definitions/operation"
        },
        "head": {
          "$ref": "#/definitions/operation"
        },
        "patch": {
          "$ref": "#/definitions/operation"
        },
        "parameters": {
          "$ref": "#/definitions/parametersList"
        },
        "x-ms-notification-content": {
          "$ref": "#/definitions/x-ms-notification-content"
        }
      }
    },
    "responses": {
      "type": "object",
      "description": "Response objects names can either be any valid HTTP status code or 'default'.",
      "minProperties": 1,
      "additionalProperties": false,
      "patternProperties": {
        "^([0-9]{3})$|^(default)$": {
          "$ref": "#/definitions/responseValue"
        },
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      },
      "not": {
        "type": "object",
        "additionalProperties": false,
        "patternProperties": {
          "^x-": {
            "$ref": "#/definitions/vendorExtension"
          }
        }
      }
    },
    "responseValue": {
      "oneOf": [
        {
          "$ref": "#/definitions/response"
        },
        {
          "$ref": "#/definitions/jsonReference"
        }
      ]
    },
    "response": {
      "type": "object",
      "required": [
        "description"
      ],
      "properties": {
        "description": {
          "type": "string"
        },
        "schema": {
          "oneOf": [
            {
              "$ref": "#/definitions/schema-dynamic-allowed"
            },
            {
              "$ref": "#/definitions/fileSchema"
            }
          ]
        },
        "headers": {
          "$ref": "#/definitions/headers"
        },
        "examples": {
          "$ref": "#/definitions/examples"
        },
        "x-ms-summary": {
          "$ref": "#/definitions/x-ms-summary"
        }
      },
      "additionalProperties": false,
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      }
    },
    "headers": {
      "type": "object",
      "additionalProperties": {
        "$ref": "#/definitions/header"
      }
    },
    "header": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "type"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "string",
            "number",
            "integer",
            "boolean",
            "array"
          ]
        },
        "format": {
          "$ref": "#/definitions/format"
        },
        "items": {
          "$ref": "#/definitions/primitivesItems"
        },
        "collectionFormat": {
          "$ref": "#/definitions/collectionFormat"
        },
        "default": {
          "$ref": "#/definitions/default"
        },
        "maximum": {
          "$ref": "#/definitions/maximum"
        },
        "exclusiveMaximum": {
          "$ref": "#/definitions/exclusiveMaximum"
        },
        "minimum": {
          "$ref": "#/definitions/minimum"
        },
        "exclusiveMinimum": {
          "$ref": "#/definitions/exclusiveMinimum"
        },
        "maxLength": {
          "$ref": "#/definitions/maxLength"
        },
        "minLength": {
          "$ref": "#/definitions/minLength"
        },
        "pattern": {
          "$ref": "#/definitions/pattern"
        },
        "maxItems": {
          "$ref": "#/definitions/maxItems"
        },
        "minItems": {
          "$ref": "#/definitions/minItems"
        },
        "uniqueItems": {
          "$ref": "#/definitions/uniqueItems"
        },
        "enum": {
          "$ref": "#/definitions/enum"
        },
        "multipleOf": {
          "$ref": "#/definitions/multipleOf"
        },
        "description": {
          "type": "string"
        },
        "x-ms-summary": {
          "$ref": "#/definitions/x-ms-summary"
        },
        "x-ms-visibility": {
          "$ref": "#/definitions/x-ms-visibility"
        }
      },
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      }
    },
    "vendorExtension": {
      "description": "Any property starting with x- is valid.",
      "additionalProperties": true,
      "additionalItems": true
    },
    "bodyParameter": {
      "type": "object",
      "required": [
        "name",
        "in",
        "schema"
      ],
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      },
      "properties": {
        "description": {
          "type": "string",
          "description": "A brief description of the parameter. This could contain examples of use.  GitHub Flavored Markdown is allowed."
        },
        "name": {
          "type": "string",
          "description": "The name of the parameter."
        },
        "in": {
          "type": "string",
          "description": "Determines the location of the parameter.",
          "enum": [
            "body"
          ]
        },
        "required": {
          "type": "boolean",
          "description": "Determines whether or not this parameter is required or optional.",
          "default": false
        },
        "schema": {
          "$ref": "#/definitions/schema-dynamic-allowed"
        },
        "x-ms-dynamic-list": {
          "$ref": "#/definitions/x-ms-dynamic-list"
        },
        "x-ms-dynamic-values": {
          "$ref": "#/definitions/x-ms-dynamic-values"
        },
        "x-ms-summary": {
          "$ref": "#/definitions/x-ms-summary"
        },
        "x-ms-test-value": {
          "$ref": "#/definitions/x-ms-test-value"
        },
        "x-ms-visibility": {
          "$ref": "#/definitions/x-ms-visibility"
        }
      },
      "additionalProperties": false
    },
    "headerParameterSubSchema": {
      "additionalProperties": false,
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      },
      "properties": {
        "required": {
          "type": "boolean",
          "description": "Determines whether or not this parameter is required or optional.",
          "default": false
        },
        "in": {
          "type": "string",
          "description": "Determines the location of the parameter.",
          "enum": [
            "header"
          ]
        },
        "description": {
          "type": "string",
          "description": "A brief description of the parameter. This could contain examples of use.  GitHub Flavored Markdown is allowed."
        },
        "name": {
          "type": "string",
          "description": "The name of the parameter."
        },
        "type": {
          "type": "string",
          "enum": [
            "string",
            "number",
            "boolean",
            "integer",
            "array"
          ]
        },
        "format": {
          "$ref": "#/definitions/format"
        },
        "items": {
          "$ref": "#/definitions/primitivesItems"
        },
        "collectionFormat": {
          "$ref": "#/definitions/collectionFormat"
        },
        "default": {
          "$ref": "#/definitions/default"
        },
        "maximum": {
          "$ref": "#/definitions/maximum"
        },
        "exclusiveMaximum": {
          "$ref": "#/definitions/exclusiveMaximum"
        },
        "minimum": {
          "$ref": "#/definitions/minimum"
        },
        "exclusiveMinimum": {
          "$ref": "#/definitions/exclusiveMinimum"
        },
        "maxLength": {
          "$ref": "#/definitions/maxLength"
        },
        "minLength": {
          "$ref": "#/definitions/minLength"
        },
        "pattern": {
          "$ref": "#/definitions/pattern"
        },
        "maxItems": {
          "$ref": "#/definitions/maxItems"
        },
        "minItems": {
          "$ref": "#/definitions/minItems"
        },
        "uniqueItems": {
          "$ref": "#/definitions/uniqueItems"
        },
        "enum": {
          "$ref": "#/definitions/enum"
        },
        "multipleOf": {
          "$ref": "#/definitions/multipleOf"
        },
        "x-ms-dynamic-list": {
          "$ref": "#/definitions/x-ms-dynamic-list"
        },
        "x-ms-dynamic-values": {
          "$ref": "#/definitions/x-ms-dynamic-values"
        },
        "x-ms-enum-values": {
          "$ref": "#/definitions/x-ms-enum-values"
        },
        "x-ms-localizeDefaultValue": {
          "$ref": "#/definitions/x-ms-localizeDefaultValue"
        },
        "x-ms-parameter-location": {
          "$ref": "#/definitions/AutoRest-x-ms-parameter-location"
        },
        "x-ms-summary": {
          "$ref": "#/definitions/x-ms-summary"
        },
        "x-ms-test-value": {
          "$ref": "#/definitions/x-ms-test-value"
        },
        "x-ms-trigger-value": {
          "$ref": "#/definitions/x-ms-trigger-value"
        },
        "x-ms-visibility": {
          "$ref": "#/definitions/x-ms-visibility"
        }
      }
    },
    "queryParameterSubSchema": {
      "additionalProperties": false,
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      },
      "properties": {
        "required": {
          "type": "boolean",
          "description": "Determines whether or not this parameter is required or optional.",
          "default": false
        },
        "in": {
          "type": "string",
          "description": "Determines the location of the parameter.",
          "enum": [
            "query"
          ]
        },
        "description": {
          "type": "string",
          "description": "A brief description of the parameter. This could contain examples of use.  GitHub Flavored Markdown is allowed."
        },
        "name": {
          "type": "string",
          "description": "The name of the parameter."
        },
        "allowEmptyValue": {
          "type": "boolean",
          "default": false,
          "description": "allows sending a parameter by name only or with an empty value."
        },
        "type": {
          "type": "string",
          "enum": [
            "string",
            "number",
            "boolean",
            "integer",
            "array"
          ]
        },
        "format": {
          "$ref": "#/definitions/format"
        },
        "items": {
          "$ref": "#/definitions/primitivesItems"
        },
        "collectionFormat": {
          "$ref": "#/definitions/collectionFormatWithMulti"
        },
        "default": {
          "$ref": "#/definitions/default"
        },
        "maximum": {
          "$ref": "#/definitions/maximum"
        },
        "exclusiveMaximum": {
          "$ref": "#/definitions/exclusiveMaximum"
        },
        "minimum": {
          "$ref": "#/definitions/minimum"
        },
        "exclusiveMinimum": {
          "$ref": "#/definitions/exclusiveMinimum"
        },
        "maxLength": {
          "$ref": "#/definitions/maxLength"
        },
        "minLength": {
          "$ref": "#/definitions/minLength"
        },
        "pattern": {
          "$ref": "#/definitions/pattern"
        },
        "maxItems": {
          "$ref": "#/definitions/maxItems"
        },
        "minItems": {
          "$ref": "#/definitions/minItems"
        },
        "uniqueItems": {
          "$ref": "#/definitions/uniqueItems"
        },
        "enum": {
          "$ref": "#/definitions/enum"
        },
        "multipleOf": {
          "$ref": "#/definitions/multipleOf"
        },
        "x-ms-dynamic-list": {
          "$ref": "#/definitions/x-ms-dynamic-list"
        },
        "x-ms-dynamic-values": {
          "$ref": "#/definitions/x-ms-dynamic-values"
        },
        "x-ms-dynamic-tree": {
          "$ref": "#/definitions/x-ms-dynamic-tree"
        },
        "x-ms-enum-values": {
          "$ref": "#/definitions/x-ms-enum-values"
        },
        "x-ms-localizeDefaultValue": {
          "$ref": "#/definitions/x-ms-localizeDefaultValue"
        },
        "x-ms-parameter-location": {
          "$ref": "#/definitions/AutoRest-x-ms-parameter-location"
        },
        "x-ms-summary": {
          "$ref": "#/definitions/x-ms-summary"
        },
        "x-ms-test-value": {
          "$ref": "#/definitions/x-ms-test-value"
        },
        "x-ms-trigger-value": {
          "$ref": "#/definitions/x-ms-trigger-value"
        },
        "x-ms-url-encoding": {
          "$ref": "#/definitions/x-ms-url-encoding"
        },
        "x-ms-visibility": {
          "$ref": "#/definitions/x-ms-visibility"
        }
      }
    },
    "formDataParameterSubSchema": {
      "additionalProperties": false,
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      },
      "properties": {
        "required": {
          "type": "boolean",
          "description": "Determines whether or not this parameter is required or optional.",
          "default": false
        },
        "in": {
          "type": "string",
          "description": "Determines the location of the parameter.",
          "enum": [
            "formData"
          ]
        },
        "description": {
          "type": "string",
          "description": "A brief description of the parameter. This could contain examples of use.  GitHub Flavored Markdown is allowed."
        },
        "name": {
          "type": "string",
          "description": "The name of the parameter."
        },
        "allowEmptyValue": {
          "type": "boolean",
          "default": false,
          "description": "allows sending a parameter by name only or with an empty value."
        },
        "type": {
          "type": "string",
          "enum": [
            "string",
            "number",
            "boolean",
            "integer",
            "array",
            "file"
          ]
        },
        "format": {
          "$ref": "#/definitions/format"
        },
        "items": {
          "$ref": "#/definitions/primitivesItems"
        },
        "collectionFormat": {
          "$ref": "#/definitions/collectionFormatWithMulti"
        },
        "default": {
          "$ref": "#/definitions/default"
        },
        "maximum": {
          "$ref": "#/definitions/maximum"
        },
        "exclusiveMaximum": {
          "$ref": "#/definitions/exclusiveMaximum"
        },
        "minimum": {
          "$ref": "#/definitions/minimum"
        },
        "exclusiveMinimum": {
          "$ref": "#/definitions/exclusiveMinimum"
        },
        "maxLength": {
          "$ref": "#/definitions/maxLength"
        },
        "minLength": {
          "$ref": "#/definitions/minLength"
        },
        "pattern": {
          "$ref": "#/definitions/pattern"
        },
        "maxItems": {
          "$ref": "#/definitions/maxItems"
        },
        "minItems": {
          "$ref": "#/definitions/minItems"
        },
        "uniqueItems": {
          "$ref": "#/definitions/uniqueItems"
        },
        "enum": {
          "$ref": "#/definitions/enum"
        },
        "multipleOf": {
          "$ref": "#/definitions/multipleOf"
        },
        "x-ms-dynamic-list": {
          "$ref": "#/definitions/x-ms-dynamic-list"
        },
        "x-ms-dynamic-values": {
          "$ref": "#/definitions/x-ms-dynamic-values"
        },
        "x-ms-enum-values": {
          "$ref": "#/definitions/x-ms-enum-values"
        },
        "x-ms-localizeDefaultValue": {
          "$ref": "#/definitions/x-ms-localizeDefaultValue"
        },
        "x-ms-parameter-location": {
          "$ref": "#/definitions/AutoRest-x-ms-parameter-location"
        },
        "x-ms-summary": {
          "$ref": "#/definitions/x-ms-summary"
        },
        "x-ms-test-value": {
          "$ref": "#/definitions/x-ms-test-value"
        },
        "x-ms-trigger-value": {
          "$ref": "#/definitions/x-ms-trigger-value"
        },
        "x-ms-visibility": {
          "$ref": "#/definitions/x-ms-visibility"
        }
      }
    },
    "pathParameterSubSchema": {
      "additionalProperties": false,
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      },
      "required": [
        "required"
      ],
      "properties": {
        "required": {
          "type": "boolean",
          "enum": [
            true
          ],
          "description": "Determines whether or not this parameter is required or optional."
        },
        "in": {
          "type": "string",
          "description": "Determines the location of the parameter.",
          "enum": [
            "path"
          ]
        },
        "description": {
          "type": "string",
          "description": "A brief description of the parameter. This could contain examples of use.  GitHub Flavored Markdown is allowed."
        },
        "name": {
          "type": "string",
          "description": "The name of the parameter."
        },
        "type": {
          "type": "string",
          "enum": [
            "string",
            "number",
            "boolean",
            "integer",
            "array"
          ]
        },
        "format": {
          "$ref": "#/definitions/format"
        },
        "items": {
          "$ref": "#/definitions/primitivesItems"
        },
        "collectionFormat": {
          "$ref": "#/definitions/collectionFormat"
        },
        "default": {
          "$ref": "#/definitions/default"
        },
        "maximum": {
          "$ref": "#/definitions/maximum"
        },
        "exclusiveMaximum": {
          "$ref": "#/definitions/exclusiveMaximum"
        },
        "minimum": {
          "$ref": "#/definitions/minimum"
        },
        "exclusiveMinimum": {
          "$ref": "#/definitions/exclusiveMinimum"
        },
        "maxLength": {
          "$ref": "#/definitions/maxLength"
        },
        "minLength": {
          "$ref": "#/definitions/minLength"
        },
        "pattern": {
          "$ref": "#/definitions/pattern"
        },
        "maxItems": {
          "$ref": "#/definitions/maxItems"
        },
        "minItems": {
          "$ref": "#/definitions/minItems"
        },
        "uniqueItems": {
          "$ref": "#/definitions/uniqueItems"
        },
        "enum": {
          "$ref": "#/definitions/enum"
        },
        "multipleOf": {
          "$ref": "#/definitions/multipleOf"
        },
        "x-ms-dynamic-list": {
          "$ref": "#/definitions/x-ms-dynamic-list"
        },
        "x-ms-dynamic-values": {
          "$ref": "#/definitions/x-ms-dynamic-values"
        },
        "x-ms-dynamic-tree": {
          "$ref": "#/definitions/x-ms-dynamic-tree"
        },
        "x-ms-enum-values": {
          "$ref": "#/definitions/x-ms-enum-values"
        },
        "x-ms-localizeDefaultValue": {
          "$ref": "#/definitions/x-ms-localizeDefaultValue"
        },
        "x-ms-parameter-location": {
          "$ref": "#/definitions/AutoRest-x-ms-parameter-location"
        },
        "x-ms-skip-url-encoding": {
          "$ref": "#/definitions/AutoRest-x-ms-skip-url-encoding"
        },
        "x-ms-summary": {
          "$ref": "#/definitions/x-ms-summary"
        },
        "x-ms-test-value": {
          "$ref": "#/definitions/x-ms-test-value"
        },
        "x-ms-trigger-value": {
          "$ref": "#/definitions/x-ms-trigger-value"
        },
        "x-ms-url-encoding": {
          "$ref": "#/definitions/x-ms-url-encoding"
        },
        "x-ms-visibility": {
          "$ref": "#/definitions/x-ms-visibility"
        }
      }
    },
    "nonBodyParameter": {
      "type": "object",
      "required": [
        "name",
        "in",
        "type"
      ],
      "oneOf": [
        {
          "$ref": "#/definitions/headerParameterSubSchema"
        },
        {
          "$ref": "#/definitions/formDataParameterSubSchema"
        },
        {
          "$ref": "#/definitions/queryParameterSubSchema"
        },
        {
          "$ref": "#/definitions/pathParameterSubSchema"
        }
      ]
    },
    "parameter": {
      "oneOf": [
        {
          "$ref": "#/definitions/bodyParameter"
        },
        {
          "$ref": "#/definitions/nonBodyParameter"
        }
      ]
    },
    "schema": {
      "type": "object",
      "description": "A deterministic version of a JSON Schema object.",
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      },
      "properties": {
        "$ref": {
          "$ref": "#/definitions/$ref"
        },
        "format": {
          "$ref": "#/definitions/format"
        },
        "title": {
          "$ref": "http://json-schema.org/draft-04/schema#/properties/title"
        },
        "description": {
          "$ref": "http://json-schema.org/draft-04/schema#/properties/description"
        },
        "default": {
          "$ref": "http://json-schema.org/draft-04/schema#/properties/default"
        },
        "multipleOf": {
          "$ref": "http://json-schema.org/draft-04/schema#/properties/multipleOf"
        },
        "maximum": {
          "$ref": "http://json-schema.org/draft-04/schema#/properties/maximum"
        },
        "exclusiveMaximum": {
          "$ref": "http://json-schema.org/draft-04/schema#/properties/exclusiveMaximum"
        },
        "minimum": {
          "$ref": "http://json-schema.org/draft-04/schema#/properties/minimum"
        },
        "exclusiveMinimum": {
          "$ref": "http://json-schema.org/draft-04/schema#/properties/exclusiveMinimum"
        },
        "maxLength": {
          "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveInteger"
        },
        "minLength": {
          "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveIntegerDefault0"
        },
        "pattern": {
          "$ref": "http://json-schema.org/draft-04/schema#/properties/pattern"
        },
        "maxItems": {
          "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveInteger"
        },
        "minItems": {
          "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveIntegerDefault0"
        },
        "uniqueItems": {
          "$ref": "http://json-schema.org/draft-04/schema#/properties/uniqueItems"
        },
        "maxProperties": {
          "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveInteger"
        },
        "minProperties": {
          "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveIntegerDefault0"
        },
        "required": {
          "$ref": "http://json-schema.org/draft-04/schema#/definitions/stringArray"
        },
        "enum": {
          "$ref": "http://json-schema.org/draft-04/schema#/properties/enum"
        },
        "additionalProperties": {
          "anyOf": [
            {
              "$ref": "#/definitions/schema"
            },
            {
              "type": "boolean"
            }
          ],
          "default": {}
        },
        "type": {
          "$ref": "http://json-schema.org/draft-04/schema#/properties/type"
        },
        "items": {
          "anyOf": [
            {
              "$ref": "#/definitions/schema"
            },
            {
              "type": "array",
              "minItems": 1,
              "items": {
                "$ref": "#/definitions/schema"
              }
            }
          ],
          "default": {}
        },
        "allOf": {
          "type": "array",
          "minItems": 1,
          "items": {
            "$ref": "#/definitions/schema"
          }
        },
        "properties": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/definitions/schema"
          },
          "default": {}
        },
        "discriminator": {
          "type": "string"
        },
        "readOnly": {
          "type": "boolean",
          "default": false
        },
        "xml": {
          "$ref": "#/definitions/xml"
        },
        "externalDocs": {
          "$ref": "#/definitions/externalDocs"
        },
        "example": {},
        "x-ms-dynamic-list": {
          "$ref": "#/definitions/x-ms-dynamic-list"
        },
        "x-ms-dynamic-values": {
          "$ref": "#/definitions/x-ms-dynamic-values"
        },
        "x-ms-enum": {
          "$ref": "#/definitions/AutoRest-x-ms-enum"
        },
        "x-ms-enum-values": {
          "$ref": "#/definitions/x-ms-enum-values"
        },
        "x-ms-localizeDefaultValue": {
          "$ref": "#/definitions/x-ms-localizeDefaultValue"
        },
        "x-ms-notification-url": {
          "$ref": "#/definitions/x-ms-notification-url"
        },
        "x-ms-summary": {
          "$ref": "#/definitions/x-ms-summary"
        },
        "x-ms-test-value": {
          "$ref": "#/definitions/x-ms-test-value"
        },
        "x-ms-visibility": {
          "$ref": "#/definitions/x-ms-visibility"
        }
      },
      "additionalProperties": false
    },
    "schema-dynamic-allowed": {
      "type": "object",
      "description": "A deterministic version of a JSON Schema object which allows dynamic schema extensions.",
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      },
      "properties": {
        "$ref": {
          "$ref": "#/definitions/$ref"
        },
        "format": {
          "$ref": "#/definitions/schema/properties/format"
        },
        "title": {
          "$ref": "#/definitions/schema/properties/title"
        },
        "description": {
          "$ref": "#/definitions/schema/properties/description"
        },
        "default": {
          "$ref": "#/definitions/schema/properties/default"
        },
        "multipleOf": {
          "$ref": "#/definitions/schema/properties/multipleOf"
        },
        "maximum": {
          "$ref": "#/definitions/schema/properties/maximum"
        },
        "exclusiveMaximum": {
          "$ref": "#/definitions/schema/properties/exclusiveMaximum"
        },
        "minimum": {
          "$ref": "#/definitions/schema/properties/minimum"
        },
        "exclusiveMinimum": {
          "$ref": "#/definitions/schema/properties/exclusiveMinimum"
        },
        "maxLength": {
          "$ref": "#/definitions/schema/properties/maxLength"
        },
        "minLength": {
          "$ref": "#/definitions/schema/properties/minLength"
        },
        "pattern": {
          "$ref": "#/definitions/schema/properties/pattern"
        },
        "maxItems": {
          "$ref": "#/definitions/schema/properties/maxItems"
        },
        "minItems": {
          "$ref": "#/definitions/schema/properties/minItems"
        },
        "uniqueItems": {
          "$ref": "#/definitions/schema/properties/uniqueItems"
        },
        "maxProperties": {
          "$ref": "#/definitions/schema/properties/maxProperties"
        },
        "minProperties": {
          "$ref": "#/definitions/schema/properties/minProperties"
        },
        "required": {
          "$ref": "#/definitions/schema/properties/required"
        },
        "enum": {
          "$ref": "#/definitions/schema/properties/enum"
        },
        "additionalProperties": {
          "anyOf": [
            {
              "$ref": "#/definitions/schema-dynamic-allowed"
            },
            {
              "type": "boolean"
            }
          ],
          "default": {}
        },
        "type": {
          "allOf": [
            {
              "$ref": "http://json-schema.org/draft-04/schema#/properties/type"
            }
          ],
          "not": {
            "description": "Note: VS Code seems to be allowing 'file' for the type but it shouldn't. Explicitly denying it here seems to produce the correct results though.",
            "enum": [
              "file"
            ]
          }
        },
        "items": {
          "anyOf": [
            {
              "$ref": "#/definitions/schema-dynamic-allowed"
            },
            {
              "type": "array",
              "minItems": 1,
              "items": {
                "$ref": "#/definitions/schema"
              }
            }
          ],
          "default": {}
        },
        "allOf": {
          "type": "array",
          "minItems": 1,
          "items": {
            "$ref": "#/definitions/schema-dynamic-allowed"
          }
        },
        "properties": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/definitions/schema-dynamic-allowed"
          },
          "default": {}
        },
        "discriminator": {
          "$ref": "#/definitions/schema/properties/discriminator"
        },
        "readOnly": {
          "$ref": "#/definitions/schema/properties/readOnly"
        },
        "xml": {
          "$ref": "#/definitions/schema/properties/xml"
        },
        "externalDocs": {
          "$ref": "#/definitions/schema/properties/externalDocs"
        },
        "example": {
          "$ref": "#/definitions/schema/properties/example"
        },
        "x-ms-dynamic-list": {
          "$ref": "#/definitions/schema/properties/x-ms-dynamic-list"
        },
        "x-ms-dynamic-values": {
          "$ref": "#/definitions/schema/properties/x-ms-dynamic-values"
        },
        "x-ms-enum": {
          "$ref": "#/definitions/AutoRest-x-ms-enum"
        },
        "x-ms-enum-values": {
          "$ref": "#/definitions/x-ms-enum-values"
        },
        "x-ms-localizeDefaultValue": {
          "$ref": "#/definitions/x-ms-localizeDefaultValue"
        },
        "x-ms-media-kind": {
          "$ref": "#/definitions/x-ms-media-kind"
        },
        "x-ms-notification-url": {
          "$ref": "#/definitions/x-ms-notification-url"
        },
        "x-ms-summary": {
          "$ref": "#/definitions/schema/properties/x-ms-summary"
        },
        "x-ms-test-value": {
          "$ref": "#/definitions/schema/properties/x-ms-test-value"
        },
        "x-ms-visibility": {
          "$ref": "#/definitions/schema/properties/x-ms-visibility"
        },
        "x-ms-dynamic-schema": {
          "$ref": "#/definitions/x-ms-dynamic-schema"
        },
        "x-ms-dynamic-properties": {
          "$ref": "#/definitions/x-ms-dynamic-properties"
        },
        "x-ms-dynamic-tree": {
          "$ref": "#/definitions/x-ms-dynamic-tree"
        }
      },
      "additionalProperties": false
    },
    "fileSchema": {
      "type": "object",
      "description": "A deterministic version of a JSON Schema object.",
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      },
      "required": [
        "type"
      ],
      "properties": {
        "title": {
          "$ref": "http://json-schema.org/draft-04/schema#/properties/title"
        },
        "description": {
          "$ref": "http://json-schema.org/draft-04/schema#/properties/description"
        },
        "default": {
          "$ref": "http://json-schema.org/draft-04/schema#/properties/default"
        },
        "required": {
          "$ref": "http://json-schema.org/draft-04/schema#/definitions/stringArray"
        },
        "type": {
          "type": "string",
          "enum": [
            "file"
          ]
        },
        "readOnly": {
          "type": "boolean",
          "default": false
        },
        "externalDocs": {
          "$ref": "#/definitions/externalDocs"
        },
        "example": {}
      },
      "additionalProperties": false
    },
    "primitivesItems": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "string",
            "number",
            "integer",
            "boolean",
            "array"
          ]
        },
        "format": {
          "$ref": "#/definitions/format"
        },
        "items": {
          "$ref": "#/definitions/primitivesItems"
        },
        "collectionFormat": {
          "$ref": "#/definitions/collectionFormat"
        },
        "default": {
          "$ref": "#/definitions/default"
        },
        "maximum": {
          "$ref": "#/definitions/maximum"
        },
        "exclusiveMaximum": {
          "$ref": "#/definitions/exclusiveMaximum"
        },
        "minimum": {
          "$ref": "#/definitions/minimum"
        },
        "exclusiveMinimum": {
          "$ref": "#/definitions/exclusiveMinimum"
        },
        "maxLength": {
          "$ref": "#/definitions/maxLength"
        },
        "minLength": {
          "$ref": "#/definitions/minLength"
        },
        "pattern": {
          "$ref": "#/definitions/pattern"
        },
        "maxItems": {
          "$ref": "#/definitions/maxItems"
        },
        "minItems": {
          "$ref": "#/definitions/minItems"
        },
        "uniqueItems": {
          "$ref": "#/definitions/uniqueItems"
        },
        "enum": {
          "$ref": "#/definitions/enum"
        },
        "multipleOf": {
          "$ref": "#/definitions/multipleOf"
        }
      },
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      }
    },
    "format": {
      "description": "Swagger data types plus some Power Platform extensions:\n- `date-no-tz` - Represents an date-time that has no time-offset (ABNF: `full-date 'T' partial-time`).\n- `html` - Tells clients to emit html editor when editing and html viewer when viewing.",
      "type": "string",
      "enum": [
        "int32",
        "int64",
        "float",
        "double",
        "byte",
        "binary",
        "date",
        "date-time",
        "password",
        "date-no-tz",
        "email",
        "html",
        "uri",
        "uuid"
      ]
    },
    "security": {
      "type": "array",
      "items": {
        "$ref": "#/definitions/securityRequirement"
      },
      "uniqueItems": true
    },
    "securityRequirement": {
      "type": "object",
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "uniqueItems": true
      }
    },
    "xml": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "name": {
          "type": "string"
        },
        "namespace": {
          "type": "string"
        },
        "prefix": {
          "type": "string"
        },
        "attribute": {
          "type": "boolean",
          "default": false
        },
        "wrapped": {
          "type": "boolean",
          "default": false
        }
      },
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      }
    },
    "tag": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "name"
      ],
      "properties": {
        "name": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "externalDocs": {
          "$ref": "#/definitions/externalDocs"
        }
      },
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      }
    },
    "securityDefinitions": {
      "type": "object",
      "additionalProperties": {
        "oneOf": [
          {
            "$ref": "#/definitions/basicAuthenticationSecurity"
          },
          {
            "$ref": "#/definitions/apiKeySecurity"
          },
          {
            "$ref": "#/definitions/oauth2ImplicitSecurity"
          },
          {
            "$ref": "#/definitions/oauth2PasswordSecurity"
          },
          {
            "$ref": "#/definitions/oauth2ApplicationSecurity"
          },
          {
            "$ref": "#/definitions/oauth2AccessCodeSecurity"
          }
        ]
      }
    },
    "basicAuthenticationSecurity": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "type"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "basic"
          ]
        },
        "description": {
          "type": "string"
        }
      },
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      }
    },
    "apiKeySecurity": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "type",
        "name",
        "in"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "apiKey"
          ]
        },
        "name": {
          "type": "string"
        },
        "in": {
          "type": "string",
          "enum": [
            "header",
            "query"
          ]
        },
        "description": {
          "type": "string"
        }
      },
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      }
    },
    "oauth2ImplicitSecurity": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "type",
        "flow",
        "authorizationUrl"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "oauth2"
          ]
        },
        "flow": {
          "type": "string",
          "enum": [
            "implicit"
          ]
        },
        "scopes": {
          "$ref": "#/definitions/oauth2Scopes"
        },
        "authorizationUrl": {
          "type": "string",
          "format": "uri"
        },
        "description": {
          "type": "string"
        }
      },
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      }
    },
    "oauth2PasswordSecurity": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "type",
        "flow",
        "tokenUrl"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "oauth2"
          ]
        },
        "flow": {
          "type": "string",
          "enum": [
            "password"
          ]
        },
        "scopes": {
          "$ref": "#/definitions/oauth2Scopes"
        },
        "tokenUrl": {
          "type": "string",
          "format": "uri"
        },
        "description": {
          "type": "string"
        }
      },
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      }
    },
    "oauth2ApplicationSecurity": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "type",
        "flow",
        "tokenUrl"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "oauth2"
          ]
        },
        "flow": {
          "type": "string",
          "enum": [
            "application"
          ]
        },
        "scopes": {
          "$ref": "#/definitions/oauth2Scopes"
        },
        "tokenUrl": {
          "type": "string",
          "format": "uri"
        },
        "description": {
          "type": "string"
        }
      },
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      }
    },
    "oauth2AccessCodeSecurity": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "type",
        "flow",
        "authorizationUrl",
        "tokenUrl"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "oauth2"
          ]
        },
        "flow": {
          "type": "string",
          "enum": [
            "accessCode"
          ]
        },
        "scopes": {
          "$ref": "#/definitions/oauth2Scopes"
        },
        "authorizationUrl": {
          "type": "string",
          "format": "uri"
        },
        "tokenUrl": {
          "type": "string",
          "format": "uri"
        },
        "description": {
          "type": "string"
        }
      },
      "patternProperties": {
        "^x-(?!ms-)": {
          "$ref": "#/definitions/vendorExtension"
        }
      }
    },
    "oauth2Scopes": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      }
    },
    "mediaTypeList": {
      "type": "array",
      "items": {
        "$ref": "#/definitions/mimeType"
      },
      "uniqueItems": true
    },
    "parametersList": {
      "type": "array",
      "description": "The parameters needed to send a valid API call.",
      "additionalItems": false,
      "items": {
        "oneOf": [
          {
            "$ref": "#/definitions/parameter"
          },
          {
            "$ref": "#/definitions/jsonReference"
          }
        ]
      },
      "uniqueItems": true
    },
    "schemesList": {
      "type": "array",
      "description": "The transfer protocol of the API.",
      "items": {
        "type": "string",
        "enum": [
          "http",
          "https",
          "ws",
          "wss"
        ]
      },
      "uniqueItems": true
    },
    "collectionFormat": {
      "type": "string",
      "enum": [
        "csv",
        "ssv",
        "tsv",
        "pipes"
      ],
      "default": "csv"
    },
    "collectionFormatWithMulti": {
      "type": "string",
      "enum": [
        "csv",
        "ssv",
        "tsv",
        "pipes",
        "multi"
      ],
      "default": "csv"
    },
    "title": {
      "$ref": "http://json-schema.org/draft-04/schema#/properties/title"
    },
    "description": {
      "$ref": "http://json-schema.org/draft-04/schema#/properties/description"
    },
    "default": {
      "$ref": "http://json-schema.org/draft-04/schema#/properties/default"
    },
    "multipleOf": {
      "$ref": "http://json-schema.org/draft-04/schema#/properties/multipleOf"
    },
    "maximum": {
      "$ref": "http://json-schema.org/draft-04/schema#/properties/maximum"
    },
    "exclusiveMaximum": {
      "$ref": "http://json-schema.org/draft-04/schema#/properties/exclusiveMaximum"
    },
    "minimum": {
      "$ref": "http://json-schema.org/draft-04/schema#/properties/minimum"
    },
    "exclusiveMinimum": {
      "$ref": "http://json-schema.org/draft-04/schema#/properties/exclusiveMinimum"
    },
    "maxLength": {
      "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveInteger"
    },
    "minLength": {
      "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveIntegerDefault0"
    },
    "pattern": {
      "$ref": "http://json-schema.org/draft-04/schema#/properties/pattern"
    },
    "maxItems": {
      "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveInteger"
    },
    "minItems": {
      "$ref": "http://json-schema.org/draft-04/schema#/definitions/positiveIntegerDefault0"
    },
    "uniqueItems": {
      "$ref": "http://json-schema.org/draft-04/schema#/properties/uniqueItems"
    },
    "enum": {
      "$ref": "http://json-schema.org/draft-04/schema#/properties/enum"
    },
    "jsonReference": {
      "type": "object",
      "required": [
        "$ref"
      ],
      "additionalProperties": false,
      "properties": {
        "$ref": {
          "$ref": "#/definitions/$ref"
        }
      }
    },
    "x-ms-api-annotation<info>": {
      "description": "[TODO] ???",
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "Production",
            "Preview"
          ]
        }
      }
    },
    "x-ms-api-annotation<operation>": {
      "description": "Used for versioning and life cycle management of an operation.",
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "family": {
          "title": "Operation family",
          "description": "Often the operationId of the first version of an operation.",
          "type": "string"
        },
        "revision": {
          "type": "integer",
          "minimum": 1
        },
        "status": {
          "$ref": "#/definitions/x-ms-api-annotation<info>/properties/status"
        },
        "replacement": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "api": {
              "type": "string"
            },
            "operationId": {
              "type": "string"
            }
          }
        }
      },
      "defaultSnippets": [
        {
          "label": "family-revision",
          "body": {
            "family": "${1:OperationId}",
            "revision": "^${2:1}"
          }
        }
      ]
    },
    "x-ms-connector-metadata": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "propertyName",
          "propertyValue"
        ],
        "properties": {
          "propertyName": {
            "type": "string"
          },
          "propertyValue": {
            "type": "string"
          }
        }
      }
    },
    "x-ms-docs": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "required": [
          "url",
          "description"
        ],
        "additionalProperties": false,
        "properties": {
          "url": {
            "type": "string",
            "format": "uri"
          },
          "description": {
            "type": "string"
          }
        }
      }
    },
    "x-ms-deployment-version": {
      "description": "[TODO] ???",
      "type": "string",
      "pattern": "^\\d+(\\.\\d+)+$"
    },
    "x-ms-dynamic-values": {
      "description": "",
      "type": "object",
      "properties": {
        "parameters": {
          "$ref": "#/definitions/DynamicOperationCall-parameters"
        },
        "value-collection": {
          "description": "A path string that evaluates to an array of objects in the response payload. If value-collection isn't specified, the response is evaluated as an array.",
          "type": "string"
        },
        "value-title": {
          "description": "A path string in the object inside value-collection that refers to the value's description.",
          "type": "string"
        },
        "value-path": {
          "description": "A path string in the object inside value-collection that refers to the parameter value.",
          "type": "string"
        }
      },
      "oneOf": [
        {
          "required": [
            "operationId"
          ],
          "properties": {
            "operationId": {
              "description": "The operation that returns the values.",
              "type": "string"
            }
          }
        },
        {
          "required": [
            "builtInOperation"
          ],
          "properties": {
            "builtInOperation": {
              "enum": [
                "AadGraph.GetUsers"
              ]
            }
          }
        },
        {
          "required": [
            "capability"
          ],
          "properties": {
            "capability": {
              "enum": [
                "file-picker"
              ]
            }
          }
        }
      ],
      "defaultSnippets": [
        {
          "label": "Dynamic Values",
          "body": {
            "operationId": "${1}",
            "value-collection": "${2:value}",
            "value-title": "${3:Name}",
            "value-path": "${4:Id}"
          }
        }
      ]
    },
    "x-ms-dynamic-list": {
      "description": "Specifies how the Power Automate designer can provide values for a parameter at design time by calling another operation to get a list of values.",
      "type": "object",
      "required": [
        "operationId"
      ],
      "properties": {
        "operationId": {
          "description": "The operation that returns the values.",
          "type": "string"
        },
        "parameters": {
          "$ref": "#/definitions/DynamicOperationCall-parameters-value-or-parameterReference"
        },
        "itemsPath": {
          "description": "A path string that evaluates to an array of objects in the response payload. If `itemsPath` isn't provided, the response is evaluated as an array.",
          "type": "string"
        },
        "itemTitlePath": {
          "description": "A path string in the object inside `itemsPath` that refers to the value's description.",
          "type": "string"
        },
        "itemValuePath": {
          "description": "A path string in the object inside `itemsPath` that refers to the item’s value.",
          "type": "string"
        }
      },
      "defaultSnippets": [
        {
          "label": "Dynamic List",
          "body": {
            "operationId": "${1}",
            "itemsPath": "${2:value}",
            "itemTitlePath": "${3:Name}",
            "itemValuePath": "${4:Id}"
          }
        }
      ]
    },
    "x-ms-dynamic-schema": {
      "description": "Specifies how the Power Automate designer can provide values for a parameter at design time by calling another operation to get a list of values.",
      "type": "object",
      "required": [
        "operationId"
      ],
      "additionalProperties": false,
      "properties": {
        "operationId": {
          "description": "The operation that returns the schema.",
          "type": "string"
        },
        "parameters": {
          "$ref": "#/definitions/DynamicOperationCall-parameters"
        },
        "value-path": {
          "description": "A path string that refers to the property that has the schema. If not specified, the response is assumed to contain the schema in the root object's properties.",
          "type": "string"
        }
      }
    },
    "x-ms-dynamic-properties": {
      "description": "Specifies how the Power Automate designer can provide values for a parameter at design time by calling another operation to get a list of values.",
      "type": "object",
      "required": [
        "operationId"
      ],
      "additionalProperties": false,
      "properties": {
        "operationId": {
          "description": "The operation that returns the schema.",
          "type": "string"
        },
        "parameters": {
          "$ref": "#/definitions/DynamicOperationCall-parameters-value-or-parameterReference"
        },
        "itemValuePath": {
          "description": "A path string that refers to the property that has the schema. If not specified, the response is assumed to contain the schema in the root object.",
          "type": "string"
        }
      }
    },
    "x-ms-dynamic-tree": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "settings": {
          // TODO
        },
        "open": {
          // TODO
        },
        "browse": {
          // TODO
        }
      }
    },
    "DynamicOperationCall-parameters": {
      "description": "An object that provides the input parameters to invoke the operation. Each property is the name of a parameter on the target operation.",
      "type": "object",
      "additionalProperties": {
        "properties": {
          "parameter": {
            "description": "The name of the parameter to use from the caller as the value for the dynamic call.",
            "type": "string"
          }
        }
      }
    },
    "DynamicOperationCall-parameters-literals-only": {
      "description": "An object that provides the input parameters to invoke the operation. Each property is the name of a parameter on the target operation.",
      "type": "object",
      "not": {
        "description": "Don't allow 'parameter' references",
        "required": [
          "parameter"
        ],
        "properties": {
          "parameter": {}
        }
      }
    },
    "DynamicOperationCall-parameters<x-ms-capabilities>": {
      "description": "An object that provides the input parameters to invoke the operation. Each property is the name of a parameter on the target operation.",
      "type": "object",
      "additionalProperties": {
        "description": "Any literal json value, with support for referencing a parameter or property.",
        "properties": {
          "parameter": {
            "description": "The name of the parameter to use from the caller as the value for the dynamic call.",
            "type": "string"
          },
          "value-property": {
            "description": "The name of a property.",
            "type": "string"
          }
        }
      }
    },
    "DynamicOperationCall-parameters-value-or-parameterReference": {
      "description": "An object that provides the input parameters to invoke the operation. Each property is the name of a parameter on the target operation.",
      "type": "object",
      "additionalProperties": {
        "oneOf": [
          {
            "type": "object",
            "minProperties": 1,
            "maxProperties": 1,
            "additionalProperties": false,
            "properties": {
              "value": {
                "description": "The literal value to be used for the input parameter."
              },
              "parameterReference": {
                "description": "This is the full parameter reference path, starting from the parameter name, followed by the path string of the property to be referenced. e.g. 'body/appId'.",
                "type": "string"
              }
            }
          }
        ]
      }
    },
    "x-ms-no-generic-test": {
      "type": "boolean"
    },
    "x-ms-operation-context": {
      "type": "object",
      "required": [
        "simulate"
      ],
      "additionalProperties": false,
      "properties": {
        "simulate": {
          "type": "object",
          "required": [
            "operationId"
          ],
          "additionalProperties": false,
          "properties": {
            "operationId": {
              "type": "string"
            },
            "parameters": {
              "$ref": "#/definitions/DynamicOperationCall-parameters"
            }
          }
        }
      }
    },
    "x-ms-pageable": {
      "type": "object",
      "description": "This extension configures an operation to be pageable.",
      "required": [
        "nextLinkName"
      ],
      "additionalProperties": false,
      "properties": {
        "nextLinkName": {
          "description": "The name of the property at the root of the response that has the next link url.\nUsage: Be sure to use the policy template (id: `updatenextlink`) to enable the correct routing of this link.",
          "type": "string",
          "examples": [
            "@odata.nextLink"
          ]
        }
      },
      "defaultSnippets": [
        {
          "label": "@odata.nextLink",
          "body": {
            "nextLinkName": "@odata.nextLink"
          }
        }
      ]
    },
    "x-ms-enum-values": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "value",
          "displayName"
        ],
        "additionalProperties": false,
        "properties": {
          "value": {
            "title": "The value in the /enum array of the parent schema object for this enum value item."
          },
          "displayName": {
            "title": "The text to display in user interfaces for this enum value. This text is localizable.",
            "type": "string"
          }
        },
        "defaultSnippets": [
          {
            "label": "new item",
            "body": {
              "value": "$1",
              "displayName": "${2:$1}"
            }
          }
        ]
      },
      "defaultSnippets": [
        {
          "label": "[...]",
          "body": [
            "^{\n    \"value\": \"$1\",\n    \"displayName\": \"${2:$1}\"\n  }$0"
          ]
        }
      ]
    },
    "x-ms-localizeDefaultValue": {
      "type": "boolean"
    },
    "x-ms-media-kind": {
      "type": "string",
      "enum": [
        "image",
        "audio"
      ]
    },
    "x-ms-notification": {
      "type": "object",
      "required": [
        "operationId"
      ],
      "additionalProperties": false,
      "properties": {
        "operationId": {
          "type": "string"
        }
      }
    },
    "x-ms-notification-url": {
      "type": "boolean"
    },
    "x-ms-notification-content": {
      "type": "object",
      "properties": {
        "schema": {
          "$ref": "#/definitions/schema-dynamic-allowed"
        }
      }
    },
    "x-ms-safe-operation": {
      "title": "Explicitly indicates whether this operation is HTTP Safe",
      "description": "By default, only HTTP methods GET and HEAD are 'safe by default'. Setting this on an operation like a POST will tell clients that it's safe.",
      "type": "boolean"
    },
    "x-ms-summary": {
      "title": "Specifies the title for an entity",
      "description": "Recommended: Use title case for `x-ms-summary`.",
      "type": "string"
    },
    "x-ms-test-value": {
      "title": "A sample value to use when running a test",
      "description": "The value should be a valid value for this entity.\nDO NOT include any secrets, keys, or personally identifiable data."
    },
    "x-ms-trigger": {
      "type": "string",
      "enum": [
        "batch",
        "single"
      ]
    },
    "x-ms-trigger-hint": {
      "type": "string"
    },
    "x-ms-trigger-metadata": {
      "type": "object",
      "required": [
        "kind",
        "mode"
      ],
      "properties": {
        "kind": {
          "enum": [
            "query"
          ]
        },
        "mode": {
          "enum": [
            "polling"
          ]
        }
      }
    },
    "x-ms-trigger-value": {
      "type": "object",
      "minProperties": 1,
      "properties": {
        "value-collection": {
          "type": "string"
        },
        "value-path": {
          "type": "string"
        }
      }
    },
    "x-ms-visibility": {
      "title": "Specifies the user-facing visibility for an entity.",
      "type": "string",
      "enum": [
        "important",
        "advanced",
        "internal"
      ]
    },
    "x-ms-url-encoding": {
      "title": "Encoding style to use for this parameter",
      "description": "Identifies if the current path parameter should be double url-encoded `double` or single url-encoded `single`. Absence of this field means `single` encoding.",
      "type": "string",
      "enum": [
        "double",
        "single"
      ],
      "default": "single"
    },
    "x-ms-capabilities<api>": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "file-picker": {
          "type": "object",
          "required": [
            "open"
          ],
          "additionalProperties": false,
          "properties": {
            "open": {
              "type": "object",
              "required": [
                "operationId"
              ],
              "additionalProperties": false,
              "properties": {
                "operationId": {
                  "type": "string"
                },
                "parameters": {
                  "$ref": "#/definitions/DynamicOperationCall-parameters<x-ms-capabilities>"
                }
              }
            },
            "browse": {
              "type": "object",
              "required": [
                "operationId"
              ],
              "additionalProperties": false,
              "properties": {
                "operationId": {
                  "type": "string"
                },
                "parameters": {
                  "$ref": "#/definitions/DynamicOperationCall-parameters<x-ms-capabilities>"
                }
              }
            },
            "value-title": {
              "type": "string"
            },
            "value-collection": {
              "type": "string"
            },
            "value-folder-property": {
              "type": "string"
            },
            "value-media-property": {
              "type": "string"
            }
          }
        },
        "testConnection": {
          "description": "Note: This feature is currently not supported for custom connectors.",
          "type": "object",
          "required": [
            "operationId"
          ],
          "additionalProperties": false,
          "properties": {
            "operationId": {
              "type": "string"
            },
            "parameters": {
              "$ref": "#/definitions/DynamicOperationCall-parameters-literals-only"
            }
          }
        }
      }
    },
    "x-ms-capabilities<operation>": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "chunkTransfer": {
          "type": "boolean"
        }
      }
    },
    "AutoRest-x-ms-parameter-location": {
      "description": "NOTE: This extension is ignored by the Power Platform. The schema is only provide here for convenience. See: http://azure.github.io/autorest/extensions/",
      "enum": [
        "client",
        "method"
      ]
    },
    "AutoRest-x-ms-skip-url-encoding": {
      "description": "NOTE: This extension is ignored by the Power Platform. The schema is only provide here for convenience. See: http://azure.github.io/autorest/extensions/",
      "type": "boolean"
    },
    "AutoRest-x-ms-enum": {
      "description": "NOTE: This extension is ignored by the Power Platform. The schema is only provide here for convenience. See: http://azure.github.io/autorest/extensions/",
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "name": {
          "type": "string"
        },
        "modelAsString": {
          "type": "boolean"
        }
      }
    }
  }
}