Skip to main content



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

For successful Code Generation, the server 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
MessageServer Parameter name is invalid.
Rule SystemSyntax
Broad CategoryOpenAPI Servers
Products ImpactedCode Generation, Developer Experience Portal
Tagscode generation sdks openapi3 openapi syntax linting apimatic server parameter name x-server-configuration

Suggested Fixes

  • Make sure the server parameter name does not contain any forbidden characters.
  • Use only letters, numbers, underscores and dashes.
  • Remove any trailing/leading white-space characters, if present.

For More Information