Improve openapi.yaml

Daniele Dal Santorequested to merge
improve-openapi-endpoints into master

Add example input object for the endpoints that need it

Merge request reports