Need to improve endpoint and parameter descriptions.
Evaluate if it's possible to use `example` in openapi.yaml: there were issue with the openapi generator.