api-tag-removed

What this check detects

A tag was removed from an operation. Tags group operations for documentation and tooling (for example the sections in Swagger UI), so removing one changes how the endpoint is grouped and displayed.

It does not affect the request or response contract, so oasdiff reports it as informational.

Example

GET /users is no longer grouped under the "admin" tag. Requests and responses are unchanged.

Change its severity

oasdiff reports api-tag-removed as informational, so it does not fail CI. To treat it as a warning or an error under your own compatibility policy, or to turn it off, set its level in a severity-levels file:

Put one rule per line; the level can be err, warn, or info, or none to disable the check entirely:

# severity.txt
api-tag-removed err

Then pass it to oasdiff:

oasdiff changelog base.yaml revision.yaml --severity-levels severity.txt