we need a swagger.json (which has to be manually generated) to provide a nice documentation for end users