Test & improve openapi specs
requested to merge reformat_and_fill_openapi_docs-improvements-nils into reformat_and_fill_openapi_docs
I went a little bit through the schemas in the openapi & try to make some adjustments, so that is accurate compared to the actual output.