Bump.sh fully supports polymorphism for OpenAPI and AsyncAPI, commonly called anyOf, oneOf and allOf. More details on these combinators can be found on each specification documentation:

To ease readability, we strongly recommend to give titles to your alternatives: it will help to identify and search them, specifically if you use this feature extensively.

Here’s an example of polymorphism in action:

Discriminator #

Both OpenAPI and AsyncAPI specifications provide support of a discriminator field, to easily identify which schema is used.

In our generated API documentation, this discriminator property is identified with a specific flag, and allowed value is explicit.

In example provided above: