Incidents API
List, create, and delete incidents using a simple HTTP API.

Do you need help with the integration?

Let us know at [email protected].

Obtaining an API token

get
https://betteruptime.com
/api/v2/incidents
Listing all existing incidents
Example cURL
1
curl --request GET \
2
--url "https://betteruptime.com/api/v2/incidents?from=2021-01-01&to=2021-01-31" \
3
--header 'authorization: Bearer YOUR_API_TOKEN'
Copied!
get
https://betteruptime.com
/api/v2/incident/:incident_id
Listing a single incident
Example cURL
1
curl --request GET \
2
--url https://betteruptime.com/api/v2/incidents/123456789 \
3
--header 'Authorization: Bearer YOUR_API_TOKEN'
Copied!
get
https://betteruptime.com
/api/v2/incident/:incident_id/timeline
List of incident timeline events
Example cURL
1
curl --request GET \
2
--url https://betteruptime.com/api/v2/incidents/123456789/timeline \
3
--header 'Authorization: Bearer YOUR_API_TOKEN'
Copied!
post
https://betteruptime.com
/api/v2/incidents
Creating a new incident
Example cURL
1
curl --request POST \
2
--url https://betteruptime.com/api/v2/incidents \
3
--header 'Authorization: Bearer YOUR_API_TOKEN' \
4
--header 'Content-Type: application/json' \
5
--data '{"summary": "Test incident", "requester_email": "[email protected]", "description": "No need to worry, everything is fine, this is just testing the great Better Uptime API."}'
Copied!
post
https://betteruptime.com
/api/v2/incidents/:incident_id/acknowledge
Acknowledge an ongoing incident
Example cURL
1
curl --request POST \
2
--url https://betteruptime.com/api/v2/incidents/123456/acknowledge \
3
--header 'Authorization: Bearer YOUR_API_TOKEN'
4
--header 'Content-Type: application/json'
5
--data '{"acknowledged_by": "[email protected]"}'
Copied!
post
https://betteruptime.com
/api/v2/incidents/:incident_id/resolve
Resolve an ongoing incident
Example cURL
1
curl --request POST \
2
--url https://betteruptime.com/api/v2/incidents/123456/resolve \
3
--header 'Authorization: Bearer YOUR_API_TOKEN'
4
--header 'Content-Type: application/json'
5
--data '{"resolved_by": "[email protected]"}'
Copied!
delete
https://betteruptime.com
/api/v2/incidents/:incident_id
Deleting an existing incident
Example cURL
1
curl --request DELETE \
2
--url https://betteruptime.com/api/v2/incidents/123456 \
3
--header 'Authorization: Bearer YOUR_API_TOKEN'
Copied!
Last modified 1mo ago