Header parameter with the name 'Accept' is ignored

Issue ID: v3-warning-parameter-header-accept

Description

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.

Example

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

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

Remediation

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