Our great sponsors
-
openapi-generator
OpenAPI Generator allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec (v2, v3)
-
WorkOS
The modern identity platform for B2B SaaS. The APIs are flexible and easy-to-use, supporting authentication, user identity, and complex enterprise features like SSO and SCIM provisioning.
What are you using for code generation from an OpenAPI spec? I was using openapi-codegen but, due to this bug in essence marking all fields as required, I consider it completely broken. There's also the issue of not supporting allOf and OneOf in the spec.
The spec is valid according to both https://editor.swagger.io/ and https://apitools.dev/swagger-parser/online/# I believe that the use of "allOf" and "oneOf" to model polymorphic responses is causing it. But it is included in the OpenAPI Spec, so we can't fault the spec in this case.