OpenAPI supports it and this feature is useful when writing code-generated API wrappers. Here is how it looks like in the OpenAPI spec: ```yaml components: responses: sampleObjectResponse: content: application/json: schema: oneOf: - $ref: '#/components/schemas/Object1' - $ref: '#/components/schemas/Object2' - $ref: 'sysObject.json#/sysObject' discriminator: propertyName: objectType mapping: obj1: '#/components/schemas/Object1' obj2: '#/components/schemas/Object2' system: 'sysObject.json#/sysObject' ``` Example was taken from [here](https://swagger.io/docs/specification/data-models/inheritance-and-polymorphism/).