Skip to main content



This rule belongs to the openapi-v3-apimatic-linting ruleset and states that:

Discriminator mapping value must specify the name or the reference to the globally defined schema to which the discriminator value needs to be mapped to. This information is useful for deserialization purposes. Therefore, the value must be non-null, non-empty and must reference to a globally defined schema.

Maximum SeverityError
MessageEmpty discriminator mapping value is not allowed.
Rule SystemSemantic
Broad CategoryOpenAPI Discriminators
Products ImpactedAPI Transformer, Code Generation, Developer Experience Portal
Tagsopenapi3 openapi apimatic semantic linting empty discriminator mapping value

Suggested Fixes

  • Make sure that the discriminator mapping values are not null or empty.
  • Ensure that the discriminator mapping values are valid schema names or references which are globally defined under the components section in OpenAPI specification.
  • Mapping value name is compared in a case-sensitive manner.

For More Information