API operations routinely respond with failure codes to a wide range of problems with the integrity of the data. The API returns HTTP response codes that correspond to the status element in the JSON response, eliminating the need to query the header for the response code.

If an error occurs, for all non–2xx HTTPS status codes, this API responds with JSON objects that provide information you can use to debug the problem. For example:

{
    "type": "bad-request",
    "title": "Bad Request",
    "instance": "3ffab427-d870-4ec0-b049-427cf58743a1",
    "status": 400,
    "detail": "The requested dimension and metric combination is not available in any of the data stores."
}

For details on information contained in the error responses, refer to Error response syntax.