operation-operationId-unique

Requires unique operationId values for each operation.

API design principle

The operationId is used by tooling to identify operations (which are otherwise done through scary looking JSON pointers).

The operationId should be unique (used only once in an OpenAPI definition).

This rule is unopinionated.

Option	Type	Description
severity	string	Possible values: `off`, `warn`, `error`. Default `error` (in `recommended` configuration).

An example configuration:

Copy

Copied

rules:
  operation-operationId-unique: error

Given this configuration:

Copy

Copied

rules:
  operation-operationId-unique: error

Example of incorrect operations:

Copy

Copied

paths:
  /cars:
    get:
      operationId: Car
      # ...
    post:
      operationId: Car
      # ...

Example of correct operations:

Copy

Copied

paths:
  /cars:
    get:
      operationId: getCar
      # ...
    post:
      operationId: postCar
      # ...

Rule source
Operation object docs
Consider using configurable rules for more specific rules for operationId s such as length, casing, and pattern enforcement.