Skip to main content



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

If the property summary is specified in the Reference Object as a sibling of property $ref, it is expected to override one specified in the referenced object provided that the referenced object supports a summary. If it does not, the Reference Object level summary has no effect.

Maximum SeverityInformation
MessageThe referenced object does not support a summary, therefore, the summary override provided in the Reference Object has no effect.
Rule SystemSemantic
Broad CategoryReferences
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsopenapi3 openapi standards semantic linting summary reference ref $ref

Suggested Fixes

  • Remove the summary property from the Reference Object as it has no effect on the referenced object.

For More Information