Property is not defined in the OpenAPI Specification

Issue ID: semantic-unknown-property

Description

The property you have defined is unknown. This property is not included in the OpenAPI Specification (OAS).

For more details, see the OpenAPI Specification.

Example

The following is an example of how this issue could look in your API definition. The OAS does not recognize a property called language for strings:

{
    "parameters": {
        "in": "query",
        "name": "id",
        "type": "string",
        "maxLength": 8,
        "language": "en-US",
        "description": "Identifier of the object to be extracted."
    }
}

Remediation

Do not use unknown properties not defined in the OAS.

{
    "parameters": {
        "in": "query",
        "name": "id",
        "type": "string",
        "maxLength": 8,
        "description": "Identifier of the object to be extracted."
    }
}