Skip to main content



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

The oneOf property in a Schema Object is a logical operator that helps infer data validity based on results of its subschemas. Therefore, if declared, it must contain at least one subschema in its list i.e. the oneOf array must not be empty.

Maximum SeverityError
MessageSchema Object oneOf list is empty.
Rule SystemSemantic
Broad CategorySchemas
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsopenapi3 openapi standards semantic validation one of json schema schema

Suggested Fixes

  • Ensure that the oneOf list contains at least one subschema.
  • If the oneOf list in the Schema Object is not expected to contain any subschemas, remove its declaration from the Schema Object.

For More Information