Skip to main content



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

The operationRef is a relative or absolute URI reference that must point to an OAS Operation Object.

Maximum SeverityError
MessageOperation reference in Link Object using operationRef does not point to an Operation Object.
Rule SystemSemantic
Broad CategoryLinks
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsopenapi3 openapi standards semantic validation operation ref ref operation link

Suggested Fixes

  • Ensure that the path provided in operationRef is a valid resolvable path.
  • Ensure that the component you are trying to reference using operationRef is indeed an Operation Object.
  • Ensure that the Operation Object being referenced contains required properties for it to be considered a valid Operation Object e.g. responses.

For More Information