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.