Improve self swagger docs

### Improvements

- Improved the service's own swagger documentation (it's now schema compliant - oops!)