Is there is a way to merge enums into one flat enum, or list?

[nomadtechie]

I am using the 2.0 spec and I have a field which I am using in a model as well as a path param where the value can be from one of three different enums. Using the syntax below is turning into an array with 3 enums. However, I would like it to be one flat enum. Is there any way to achieve this?

Thanks so much:

    properties:
      type:
        type: "string"
        enum: 
        - *unitTypes
        - *componentTypes
        - *snootTypes

[hkosova]

YAML does not support this.

where the value can be from one of three different enums.

In OpenAPI 3.0 this can probably be handled using oneOf:

components:
  schemas:
    Colors1:
      type: string
      enum: [red, green, blue]
    Colors2:
      type: string
      enum: [black, white]
    
    Color:
      oneOf:
        - $ref: '#/components/schemas/Colors1'
        - $ref: '#/components/schemas/Colors2'

[nomadtechie]

Thanks so much @hkosova! That is helpful for my models, but can I also use this for my path param? Also, I'm assuming there is no way to do this in OpenAPI 2.0?

[hkosova]

can I also use this for my path param?

Yes. In 3.0, all parameters use a schema, so the syntax would be similar to models:

- in: path
  name: color
  required: true
  schema:
    oneOf:
      - $ref: '#/components/schemas/Colors1'
      - $ref: '#/components/schemas/Colors2'

I'm assuming there is no way to do this in OpenAPI 2.0?

Correct. oneOf is a new feature in 3.0.

[riba2101]

just a note - this does not work, the resulting Color is an empty class, also there is a bug if you use allOf the parent extends the enum.

the above mentioned is valid for java generator

[idromigny]

Hello, just found this because I was searching for another solution than doing this solution of the oneOf. Just wanted to say that it's working for me at the condition I specify the type at the oneOf level too :

- in: path
  name: color
  required: true
  schema:
    type: string
    oneOf:
      - $ref: '#/components/schemas/Colors1'
      - $ref: '#/components/schemas/Colors2'

I'm using this for query parameter though. Don't know if it's changing anything about the fact that's working.