Skip to main content



This rule belongs to the openapi-v3-standards-validation ruleset and states that:

An example for a parameter can be provided in multiple ways: either directly in the Parameter Object using the examples/example property or within the parameter level schema definition using the example property. If an example is provided at both levels, the Parameter Object level examples will override the Schema Object level example.

Maximum SeverityInformation
MessageParameter Object level examples found that override the example present in the parameter's schema definition.
Rule SystemSemantic
Broad CategoryParameters
Products ImpactedAPI Transformer, Developer Experience Portal
Tagsopenapi3 openapi standards semantic validation examples parameter schema

Suggested Fixes

  • If the parameter schema level example adds no new example value as compared to the one at Parameter Object level, remove the schema level example property.

For More Information