Explore documentation
  1. Welcome to Uptime 👋
  2. Frequently Asked Questions
  3. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  4. On-call scheduling and alerting
    1. Get started
    2. Sending alerts to Slack ↗
    3. Connecting external calendars
    4. Advanced guide
  5. Incidents
    1. Get started
    2. Advanced guide
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Integrations
    1. Integrating with Better Stack
  8. Team and account management
    1. Team management
    2. Account settings
    3. Audit logs
    4. Migrating to pay as you go
  9. Uptime API
    1. Get an API token
    2. Monitors
    3. Heartbeats
    4. On-call & incidents
      1. On-call calendar
      2. On-call calendar events
      3. On-call calendar rotations
      4. Escalation policies
      5. Escalation policy groups
      6. Severities
      7. Severity groups
      8. Incidents
        1. List incidents GET
        2. Get incident GET
        3. List incident timeline GET
        4. Create incident POST
        5. Acknowledge incident POST
        6. Resolve incident POST
        7. Escalate incident POST
        8. Remove incident DELETE
        9. Response attributes
      9. Comments
    5. Status pages
    6. Metadata
    7. Integrations

Escalate incident

This will escalate an ongoing incident to another team member, a team, different escalation policy, or the whole organization.

POST https://uptime.betterstack.com/api/v3/incidents/{incident_id}/escalate

URL parameters

incident_id
required string

The ID of the incident you want to get

Headers

Authorization
required string

Bearer $TOKEN

Body parameters

escalation_type
required string

Who should we escalate this incident to?
Possible values: User, Team, Schedule, Policy, and Organization

user_email
string

Define which team member to escalate to.
Either user_email or user_id required when escalating to User.

user_id
integer

Define which team member to escalate to.
Either user_email or user_id required when escalating to User.

team_name
string

Define which team to escalate to.
Either team_name or team_id required when escalating to Team.

team_id
integer

Define which team to escalate to.
Either team_name or team_id required when escalating to Team.

schedule_id
integer

Define which on-call calendar to escalate to. Required when escalating to Schedule.

policy_id
integer

Define which escalation policy to escalate to. Required when escalating to Policy.

call
boolean

Should we call?
Can be used when escalating to User, Team, Schedule, or Organization.

sms
boolean

Should we send an SMS?
Can be used when escalating to User, Team, Schedule, or Organization.

email
boolean

Should we send an email?
Can be used when escalating to User, Team, Schedule, or Organization.

push
boolean

Should we send a push notification?
Can be used when escalating to User, Team, Schedule, or Organization.

critical_alert
boolean

Should we send a critical push notification that ignores the mute switch and Do not Disturb mode?
Can be used when escalating to User, Team, Schedule, or Organization.

200

Returned when an incident was escalated successfully

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"
        }
      }
    }
  }
}
409

Returned when an incident was already resolved

Response body

{
  "errors": "Cannot escalate a resolved incident."
}

Example cURL

User Team Schedule Policy Organization 
curl --request POST \
  --url https://uptime.betterstack.com/api/v3/incidents/123456/escalate \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "escalation_type": "User",
    "user_email": "mail@example.com",
    "email": true,
    "push": true
  }'
curl --request POST \
  --url https://uptime.betterstack.com/api/v3/incidents/123456/escalate \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "escalation_type": "Team",
    "team_name": "My Team",
    "email": true,
    "push": true
  }'
curl --request POST \
  --url https://uptime.betterstack.com/api/v3/incidents/123456/escalate \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "escalation_type": "Schedule",
    "schedule_id": 123,
    "call": true,
    "push": true,
    "critical_alert": true
  }'
curl --request POST \
  --url https://uptime.betterstack.com/api/v3/incidents/123456/escalate \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "escalation_type": "Policy",
    "policy_id": 123
  }'
curl --request POST \
  --url https://uptime.betterstack.com/api/v3/incidents/123456/escalate \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "escalation_type": "Organization",
    "push": true
  }'

Previous article

Resolve incident

Next article

Remove incident