So, for 2, what I mean is stuff like: GET /api/object/<id>?withAdditionalMetadata=1&expandChildren=1&..... So then the OpenAPI schema has to be something

So, for 2, what I mean is stuff like: GET /api/object/<id>?withAdditionalMetadata=1&expandChildren=1&..... So then the OpenAPI schema has to be something like: schema: oneOf: - $ref: '#/components/schemas/Object' - $ref: '#/components/schemas/ObjectWithMetadata' - $ref: '#/components/schemas/ObjectWithChildren' - $ref: '#/components/schemas/ObjectWithChildrenAndMetadata So inevitably the client ends up being quite complex to handle this.