no-enum-type-mismatch

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude

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

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

An example configuration:

rules:
  no-enum-type-mismatch: error

Examples

Given this configuration:

rules:
  no-enum-type-mismatch: error

Example of incorrect enum values given the enum type:

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

Example of correct enum values given the enum type:

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

Related rules

• no-schema-type-mismatch
• no-required-schema-properties-undefined
• configurable rules
• no-invalid-media-type-examples
• no-invalid-parameter-examples
• no-invalid-schema-examples

Resources

• Rule source
• Enum documentation