Defining enum for array in Swagger 2.0

Question

type\": \"array\",
\"items\": {
    \"type\": \"string\",
    \"enum\": [\"MALE\",\"FEMALE\",\"WORKER\"]
}

or

type\": \"array\",
\"         


        

Answer 1

The first case is correct and these days swagger-ui generates a multiple-choise select of the enum values.

Answer 2

It will depend on what you want to enum:

Each enum value MUST be of the described object type

• in first case a String
• in second one an Array of String

First syntax means These are the possible values of the String in this array

AnArray:
  type: array
  items:
    type: string
    enum:
      - MALE
      - FEMALE
      - WORKER

This array can contain multiple String, but each String must have MALE, FEMALE or WORKER value.

Second one means These are the possible values of this Array

AnotherArray:
  type: array
  items:
    type: string
  enum:
    - 
      - FEMALE
      - WORKER
    -
      - MALE
      - WORKER

Each enum value is therefore an array. In this example, this array can only have to possible value ["FEMALE","WORKER"] and ["MALE","WORKER"].

Unfortunately even if this syntax is valid, no enum values are shown in Swagger UI.