Choosing and Implementing OpenAPI Discriminators for Polymorphic Schemas
Learn when to use an OpenAPI discriminator for polymorphic schemas, how it compares to oneOf/anyOf, and see a concrete Pet API example with validation steps.
Loading…
ReadMeFeed / Community knowledge
#polymorphic-schema
Real questions. Useful conversations. Find the people who know your stack.
openapiModeling Polymorphic Responses in OpenAPI 3.1 with Discriminators
An API that returns different shapes for the same endpoint forces clients to guess. A discriminator in OpenAPI 3.1 makes polymorphic responses explicit by naming a property that selects the concrete subtype in a oneOf composition.