Skip to main content



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

For successful Code Generation, the operation 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
MessageOperation level parameter name is invalid.
Rule SystemSyntax
Broad CategoryOpenAPI Operations
Products ImpactedCode Generation, Developer Experience Portal
Tagscode generation sdks openapi3 openapi syntax linting apimatic operation parameter name

Suggested Fixes

  • Make sure the parameter name of the operation 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 of the operation object cannot be changed, remove the component definition and its references (if any), to avoid issues.

For More Information