Skip to content

Latest commit

 

History

History
27 lines (23 loc) · 658 Bytes

describing-enums.md

File metadata and controls

27 lines (23 loc) · 658 Bytes
description
Learn how to add descriptions to enums.

Describing enums

When an API operation includes an enum, you can add x-enumDescriptions to provide more context about each option. GitBook will display the enum values and their descriptions in a table next to the operation.

{% code title="openapi.yaml" %}

openapi: '3.0'
info: ...
components:
  schemas:
    project_status:
      type: string
      enum:
        - LIVE
        - PENDING
        - REJECTED
      x-enumDescriptions:
        LIVE: The project is live.
        PENDING: The project is pending approval.
        REJECTED: The project was rejected.

{% endcode %}