Skip to main content



This rule belongs to the swagger-v2-syntax-validation ruleset and states that:

If any additional property needs to be added in the Swagger specification that is otherwise not part of the actual standard, specification extension can be used for this purpose at certain points. The extension name must begin with x- (e.g. x-internal-id).

Maximum SeverityError
MessageSpecification extension name is invalid.
Rule SystemSyntax
Broad CategorySpecification Extensions
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsswagger2 swagger syntax validation name specification extensions vendor extensions extensions

Suggested Fixes

  • Make sure that the name of the extension begins with a lower case 'x' which is then followed by a dash '-'. There must be no spaces between the two.
  • There must be no trailing whitespace characters at the start of the extension name.
  • Ensure that the current object allows for extensions.

For More Information