openapi: create REST API documentation

This is a draft for the team manager service REST documentation.
For the magic to happen, copy the content into
https://editor.swagger.io/.

TODO: add additional services