Prefix is not a known prefix

Issue ID: v3-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:

{
    "responses": {
        "200": {
            "description": "Expected response to a valid request",
            "content": {
                "aplication/json": {
                    "schema": {
                        "$ref": "#/components/schemas/Pet"
                    }
                }
            }
        }
    }
}

Remediation

Make sure that you only use known media type prefixes.

{
    "responses": {
        "200": {
            "description": "Expected response to a valid request",
            "content": {
                "application/json": {
                    "schema": {
                        "$ref": "#/components/schemas/Pet"
                    }
                }
            }
        }
    }
}