We use conventional HTTP response codes to indicate the success or failure of an API request. There are three general response code ranges you can expect to receive:
1. 2xx indicates a successful request.
2. 4xx indicates a failed request due to a problem with the information provided. (For example, a request parameter was not included or a specified task was not found in a runbook).
3. 5xx indicates an error with our servers. Note that these errors will be rare.
The following standard HTTP status codes are used in the API:
4xx HTTP response codes return a specific error code and accompanying detail (a description of the error) in the body of the response.
For example, this is a 404 response body:
"title": "Not Found",
"detail": "This link is not valid. This may be because the item is archived or you do not have access to it.",
The "title" and "detail" strings may change or get translated in future API versions, therefore we recommend using the "code" field to map errors programmatically.
Here is a full list of possible error codes: