Skip to main content



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

In OpenAPI specifications, path parameters are defined by enclosing the parameter name in curly braces {} within the URL path. This rule enforces the requirement that path parameter declarations cannot be empty, as an empty path parameter declaration does not provide any useful information about the parameter.

Maximum SeverityError
MessageEmpty path parameter declaration found.
Rule SystemSyntax
Broad CategoryOpenAPI Paths
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsopenapi3 openapi syntax linting apimatic path parameter empty declaration

Suggested Fixes

  • Check the OpenAPI specification to identify any path parameter declarations that are empty.
  • If any path parameter declarations are empty, update them with a valid parameter name.

For More Information