There are a number of issues in the area of OpenAPI and Swagger. They are all gathered together on the Epic - POLICY-4123Getting 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-4142Getting issue details... STATUS and - POLICY-4142Getting 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-4142Getting issue details... STATUS .