Escalation Policies API

Manage your escalation policies using simple HTTP API.

Do you need help with the integration?

Let us know at hello@betteruptime.com.

Obtaining an API token

Please, see Obtaining an API token.

get
List all escalation policies

https://betteruptime.com/api/v2/policies
Returns list of escalation policies.
Request
Response
Request
Headers
Authorization
required
string
Bearer YOUR_API_TOKEN
Response
200: OK
Paginated list of escalation policies.
{
"data": [
{
"id": "123",
"type": "policy",
"attributes": {
"name": "Policy A",
"repeat_count": 5,
"repeat_delay": 0,
"incident_token": "8nEiLj2gfqjfQRK6vzkFuGC25"
}
},
{
"id": "456",
"type": "policy",
"attributes": {
"name": "Policy B",
"repeat_count": 3,
"repeat_delay": 300,
"incident_token": "vZpYuaRYvLa6t2yqRqHTmEVKu"
}
}
],
"pagination": {
"first": "https://betteruptime.com/api/v2/policies?page=1",
"last": "https://betteruptime.com/api/v2/policies?page=1",
"prev": null,
"next": null
}
}
Example cURL
Example cURL
curl --request GET \
--url https://betteruptime.com/api/v2/policies \
--header 'Authorization: Bearer YOUR_API_TOKEN'

get
Getting a single escalation policy

https://betteruptime.com/api/v2/policies/:policy_id
Returns a single escalation policy.
Request
Response
Request
Path Parameters
policy_id
required
string
The ID of the policy you're interested in.
Headers
Authorization
required
string
Bearer YOUR_API_TOKEN
Response
200: OK
{
"data": {
"id": "123",
"type": "policy",
"attributes": {
"name": "Policy A",
"repeat_count": 5,
"repeat_delay": 0,
"incident_token": "8nEiLj2gfqjfQRK6vzkFuGC25"
}
}
}
404: Not Found
{
"errors": "Resource with provided ID was not found"
}
Example cURL
Example cURL
curl --request GET \
--url https://betteruptime.com/api/v2/policies/123 \
--header 'Authorization: Bearer YOUR_API_TOKEN'