Comment on page
Errors
All responses from the API will include a standard HTTP successful or error status code. The successful status codes are as follows:
HTTP Status Code | Description |
|---|---|
200 OK | The request was successful. |
For errors, we include extra information as to why the request was not successful. The error response body will have the following format:
{
"error": {
"message": "Descriptive information about the error",
"code": "HTTP error code",
}
}
For example, if you try to retrieve a recording that does not exist, you will get the following error response:
{
"error": {
"message": "Recording not found or does not exist",
"code": 404,
}
}
The error status codes, along with their error types, are as follows:
HTTP Status Code | Description |
|---|---|
400 Bad Request | The request cannot be accepted. Might be because the request body is empty when it should not be. |
401 Unauthorized | The access token provided is invalid or deactivated. |
404 Not Found | We could not find any record associated with this request. |
500 Internal Server Error | Something went wrong with the Screendesk API. |
Last modified 1yr ago