Skip to main content



This rule belongs to the import-validation ruleset and states that:

If a component is referenced using a local or external reference path, the path must be resolvable.

Maximum SeverityBlocking
MessageReference could not be resolved.
Rule SystemSemantic
Broad CategoryReferences Rules
Tagsimport api specification api file validation reference $ref

Suggested Fixes

  • If this is a local reference, make sure that the component exists at the path specified. A local reference usually starts with a #.
  • If this is an external reference to a local file, make sure that the relative path to the file is valid and the component exists in that file.
  • If your spec is split into multiple files, ensure you are uploading all of them using a ZIP file.
  • If this is an external reference to a file via a URL, make sure that the URL is publicly accessible.