Skip to main content



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

An input API specification can fail to import if it contains validation issues (e.g. input files may not be valid against standard formats) or if the import process ran into internal issues. You can attempt to fix the file using given suggestions and troubleshooting tips below or contact APIMatic team for more details.

Maximum SeverityBlocking
MessageProvided API specification failed to import.
Rule SystemSemantic
Broad CategoryProcesses
Tagsprocess apimatic semantic validation import api specification

Suggested Fixes

  • Resolve any specification related errors/warnings to proceed further.
  • Ensure that your file uses valid JSON/YAML/XML.
  • Ensure that the file does not contain any circular references.
  • Ensure that any required properties are not missing.
  • Visit the official standard documentation of the format, that your file uses, to determine the root cause of the issue.
  • Avoid using any special/forbidden characters in your files.
  • Ensure that your file does not have any unexpected nulls.
  • Ensure that all files are in one of the supported formats only.
  • Make sure that the file contents are complete.
  • Contact APIMatic team for more details if you think the API specification is valid and still failing to import.

For More Information