Skip to main content



This rule belongs to the swagger-v2-standards-validation ruleset and states that:

The name specified for the discriminator in the Schema Object must correspond with a schema property definition in the properties of the schema object it is part of.

Maximum SeverityError
MessageThe discriminator property name does not exist in the schema properties.
Rule SystemSemantic
Broad CategorySchemas
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsswagger2 swagger standards semantic validation discriminator name schema schema object properties property

Suggested Fixes

  • Add a definition for the property under the properties property of the Schema Object if you haven't added already.
  • Make sure that the name assigned to the discriminator in the Schema Object matches exactly with the name of one of the properties defined under the same Schema Object. Names are compared in a case-sensitive manner.

For More Information