Skip to main content



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

Templated paths should not lead to an ambiguous resolution e.g. /{entity}/me and /books/{id} can result in the same path depending upon the values substituted and so are considered ambiguous.

Maximum SeverityWarning
MessagePath may result in ambiguous resolution.
Rule SystemSemantic
Broad CategoryPaths
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsopenapi3 openapi standards semantic linting template paths path

Suggested Fixes

  • If you are sure that the ambiguous templated paths are not likely to conflict with each other because of their possible substitution values, you may ignore this warning.
  • If one of the ambiguous paths cover all information of the other path as well, consider removing one of the path definitions.

For More Information