Skip to main content



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

The provided Google Discovery document must not contain any syntax/semantic issues and use only valid JSON. Each property in the file must have a type as defined in the standard.

Maximum SeverityBlocking
MessageProvided Google Discovery document is not valid.
Rule SystemSemantic
Broad CategoryBasic Structure
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsgoogle discovery api semantic validation syntax

Suggested Fixes

  • Ensure that the file uses valid JSON.
  • Ensure that each element in the Google Discovery document has the expected type.
  • Ensure that an array is not defined as an object or vice versa.
  • Ensure that where a number is expected, a string value is not provided, etc.
  • For objects, ensure that each property has a correct type assigned to it.

For More Information