Skip to main content



This rule belongs to the openapi-v3-docsgen-linting ruleset and states that:

Media Type Object must specify a non-null, non-empty example value using either the example or examples property.

Maximum SeverityInformation
MessageMedia type object example is missing.
Rule SystemSemantic
Broad CategoryOpenAPI Media Types
Products ImpactedDeveloper Experience Portal
Tagsdocumentation generation documentation docs openapi3 openapi semantic linting apimatic examples example media type

Suggested Fixes

  • Ensure that either example or examples property is present in the Media Type Object.
  • example and examples are mutually exclusive properties.
  • When using the examples list, make sure that the list is not empty.
  • Ensure that the media type example value is not empty or null.
  • The example value specified must be valid in accordance with the media type schema definition.

For More Information