This is caused by when the API returns an unexpected condition to the integration.
It is best practice to examine the HTTP response code for non-200 responses and including some logic to deal with that situation.
Additionally it is best practice to examine the Error object of the JSON response even if a 200 HTTP response is received.
A Rally WSAPI JSON response will always include an Error object as highlighted below and if the API encounters a problem with fulfilling the request, it will populate that object with an error
{
"OperationResult":{
"_rallyAPIMajor": "2",
"_rallyAPIMinor": "0",
"Errors":[
"Could not read: Could not read Defect <DEFECT_OID> to update."
],
"Warnings":[]
}
}
Keywords: Agile Central Webservices WS-API WSAPI