Only success messages are documented for Accounts API

When looking into docs to see what different responses are possible, only status 200 is documented. We should document failure and error states as well.

Example: https://api.eclipse.org/#operation/RetrieveUser