Skip to main content



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

The Operation Object must specify one or more tags using the tags property. Tags are used for logical grouping of operations. This facilitates their discovery and consequently eases API consumption.

Maximum SeverityWarning
MessageOperation object's tags are empty or missing.
Rule SystemSemantic
Broad CategoryOpenAPI Operations
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsopenapi3 openapi apimatic semantic linting tags tag operation

Suggested Fixes

  • Ensure that the tag list is present in the Operation Object using the tags property.
  • Ensure that the tag list is not empty.
  • Ensure that the tag list contains at least one tag entry.
  • The tag can represent the resource the operations belong to or a user-friendly category that can help group those operations together.

For More Information