- [ ] All endpoints should have detailed and consistent descriptions visible in swagger.json (including possible http responses)