The rest API documentation should contain error response examples

[jonconley_sg]

This is important for responses that differ in structure than the success response.  For instance, under error, the CRUD account update returns an undocumented field, "message". 

{
  "message": "An unexpected error occurred"
}

A success, on the other hand, returns

{
  "Success": true,
  "Id": "2c93808457d787030157e0321fdf4fab"
}

[ls-zuora]

we've had the exact same problems, this could be a problem with authentication (sounds very strange, but that happened with us...)

see here:

https://community.zuora.com/t5/API/Using-Security-Token-with-REST-API/m-p/17538#M905