API operations routinely respond with failure codes to a wide range of problems with the integrity of the data you're trying to modify. 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. The API responds with a JSON object that looks like this:

    "status": "400",
    "instance": "49046f42-f51f-403b-be60-6fb8179aa1d2",
    "detail": "Start date and End date are same",
    "title": "Bad Request"

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