Skip to main content



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

The OperationId field in the OpenAPI specification is used to uniquely identify an operation. To ensure consistency and clarity, it is recommended that the OperationId should not contain coordinating conjunctions like and, but, for. These words can make the name of the operation unnecessarily long and can make it harder to read and understand.

Maximum SeverityWarning
MessageOperationId should not contain any coordinating conjunction such as and, but or for.
Rule SystemSemantic
Broad CategoryOpenAPI Operations
Products ImpactedCode Generation, Developer Experience Portal
Tagscode generation sdks openapi3 openapi semantic linting apimatic operationId coordinating conjunction and but for

Suggested Fixes

  • Remove all Coordinating Conjunctions such as (but, for, and) from the OperationId.

For More Information