Prefix is not a known prefix

Issue ID: warning-content-type-unknownprefix

Description

You are referencing a media type using an unknown prefix. All media types referenced should be proper MIME types.

Known prefixes for media types are:

  • application
  • audio
  • font
  • example
  • image
  • message
  • model
  • multipart
  • text
  • video

For more details, see RFC 2046.

Example

The following is an example of how this issue could look in your API definition. The media type prefix has been misspelt:

{
    "/pets": {
        "put": {
            "summary": "Updates a pet in the store with form data",
            "operationId": "updatePetWithForm",
            "produces": [
                "aplication/json"
            ],
            "parameters": [
                // ...
            ]
        }
    }
}

Remediation

Make sure that you only use known media type prefixes.

{
    "/pets": {
        "put": {
            "summary": "Updates a pet in the store with form data",
            "operationId": "updatePetWithForm",
            "produces": [
                "application/json"
            ],
            "parameters": [
                // ...
            ]
        }
    }
}