There are a number of issues in the area of OpenAPI and Swagger. They are all gathered together on the Epic POLICY-4123 - Getting issue details... STATUS .
Over time, we will move from generating the OpenAPI (Swagger) artifacts from annotations in the code to having interfaces generated from source OpenAPI artifacts, see POLICY-4142 - Getting issue details... STATUS and POLICY-4142 - Getting issue details... STATUS .
In the current implementation, we are using SpringFox to generate teh Swagger from the Swagger 2 annotations, but SpringFox has many bugs, is not maintained, and uses an old version of SpringBoot, preventing us from upgrading SpringBoot, see POLICY-4142 - Getting issue details... STATUS .