This will acknowledge an ongoing incident, preventing further escalations.
URL parameters
The ID of the incident you want to get
Headers
Bearer $TOKEN
Body parameters
User e-mail or a custom identifier of the entity that acknowledged the incident
Returned when an incident was acknowledged succesfully
Response body
{
"data": {
"id": "123456789",
"type": "incident",
"attributes": {
"name": "uptime homepage",
"url": "https://uptime.betterstack.com/",
"http_method": "get",
"cause": "Status 500",
"incident_group_id": null,
"started_at": "2020-03-09T17:37:56.662Z",
"acknowledged_at": "2020-03-09T18:37:56.662Z",
"acknowledged_by": "Elon Musk",
"resolved_at": null,
"resolved_by": null,
"response_content": "\n404 Not Found\n\nNot Found\nThe requested URL /fail was not found on this server.\n",
"response_options": "{}",
"regions": [
"us",
"eu",
"as",
"au"
],
"response_url": null,
"screenshot_url": null,
"origin_url": null,
"escalation_policy_id": null,
"call": true,
"sms": true,
"email": true,
"push": true
},
"relationships": {
"monitor": {
"data": {
"id": "2",
"type": "monitor"
}
}
}
}
}Returned when an incident was already acknowledged
Response body
{
"errors": "Incident was already acknowledged"
}curl --request POST \
--url https://uptime.betterstack.com/api/v2/incidents/123456/acknowledge \
--header "Authorization: Bearer $TOKEN"
--header 'Content-Type: application/json'
--data '{"acknowledged_by": "elon@spacex.com"}'