swagger docs and users endpoint updated

[selombanybah]

This is a small update to make sure all the calls work as expected in swagger UI. I also handled some few errors in the users endpoints