Header parameter with the name 'Content-Type' is ignored

Issue ID: v3-warning-parameter-header-content-type


You have used a restricted value as the name of a header parameter. The values Accept, Content-Type, and Authorization are restricted values and should not be used as the header name. A header with any of these values as the header name is ignored.

For more details, see the OpenAPI Specification.


The following is an example of how this issue could look in your API definition:

    "name": "Content-Type",
    "in": "header",
    "description": "Supported content types",
    "required": true,
    "schema": {
        "type": "string",
        "pattern": "^application/json$|^application/xml$"


Make sure that you do not use the restricted values as header parameter names.