Status Codes and Errors

Sadly, sometimes requests to the API are not successful. Failures can occur for a wide range of reasons. In all cases, the API should return an HTTP Status Code that indicates the nature of the failure (below), with a response body in JSON format containing additional information.

200 Success

If data was requested, it will be available in the data field at the top level of the response body.

201 Created

Its information is available in the datafield at the top level of the response body. The Resource URL where the object can be retrieved is also returned in the Location header of the response.

400 Bad Request

This usually occurs because of a missing or malformed parameter. Check the documentation and the syntax of your request and try again.

401 Unauthorized

You are not authenticated or your credentials are expired. Authenticate first, in order to perform this action.

403 Forbidden

You don't have enough permissions to perform this action.

404 Not Found

Either the request method and path supplied do not specify a known action in the API, or the object specified by the request does not exist.

500 Internal Server Error

There was a problem on our end.

In case of an error, the response body will contain a list of errors:

Response with errors

HTTP/1.1 400 Bad Request
{ 
    "type": "Type 'Spory' is not valid. Please, choose a valid value from the list: Story, Bug, Risk, Issue, Feedback, Task"
}