doc: add descriptions to responses and common types

HINT 1: To review any OpenApi docs, use the editor https://editor.swagger.io/

HINT 2: use the typescript-angular client generator to validate oneOf structures (such as the tasks on the profiles)