Skip to main content



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

For successful Code Generation, the path item level parameter name must only use letters, numbers, underscores and dashes. It must not contain any leading/trailing white-space characters. Names are often used for naming the files generated as part of the code generation process, so, any forbidden file name characters are not allowed.

Maximum SeverityError
MessagePath item level parameter name is invalid.
Rule SystemSyntax
Broad CategoryOpenAPI Path Items
Products ImpactedCode Generation, Developer Experience Portal
Tagscode generation sdks openapi3 openapi syntax linting apimatic path parameter name

Suggested Fixes

  • Make sure the parameter name of the path item object does not contain any forbidden characters.
  • Use only letters, numbers, underscores and dashes.
  • Remove any trailing/leading white-space characters, if present.
  • If the parameter name in path item object cannot be changed, remove the component definition and its references (if any), to avoid issues.

For More Information