Skip to main content



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

String value should be in the format of a proper URL. The URL path can be relative only if a server URL exists in the API document to help resolve the URL path into an absolute path.

Maximum SeverityError
MessageURL is invalid.
Rule SystemSyntax
Broad CategoryMiscellaneous
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsopenapi3 openapi syntax validation url

Suggested Fixes

  • If the URL is a relative path, ensure that OpenAPI Server Object contains a server URL.
  • If the OpenAPI document does not contain any servers information, ensure that the URL is an absolute path.
  • Ensure that the URL does not contain any forbidden characters.

For More Information