no-enum-type-mismatch

Requires that the contents of every enum value in your API description conform to the corresponding schema's specified type.

OAS Compatibility
2.0
3.0
3.1
components
NamedParameter
NamedSchema
Root
Paths
PathItem
Operation
Parameter
Schema
RequestBody
MediaType
Responses

API design principles

If a property is defined for a certain type, then its corresponding enum values should comply with that type. Lack of compliance is most likely the result of a typo.

Configuration

Option Type Description
severity string Possible values: off, warn, error. Default error (in recommended configuration).

An example configuration:

Copy
Copied
rules:
  no-enum-type-mismatch: error

Examples

Given this configuration:

Copy
Copied
rules:
  no-enum-type-mismatch: error

Example of incorrect enum values given the enum type:

Copy
Copied
properties:
  huntingSkill:
    type: string
    description: The measured skill for hunting
    enum:
      - adventurous
      - 12
      - 3.14

Example of correct enum values given the enum type:

Copy
Copied
properties:
  huntingSkill:
    type: string
    description: The measured skill for hunting
    enum:
      - adventurous
      - aggressive
      - passive

Related rules

Resources