OpenAPI Best Practices

general > operation-singular-tag

Guidance / Message

Use only one tag for operation '{{apiContract.method}}' to avoid duplicate content.

Examples

valid

paths:
  /events:
    get:
      tags:
        - events

invalid

paths:
  /events:
    get:
      tags:
        - events
        - eventsplus

Applies to Operation

Constraint

Type: Declarative Validation