Skip to main content
PUT
/
v1
/
escalation_paths
/
{id}
Update an escalation path
curl --request PUT \
  --url https://api.rootly.com/v1/escalation_paths/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '
{
  "data": {
    "type": "escalation_paths",
    "attributes": {
      "name": "<string>",
      "notification_type": "audible",
      "default": true,
      "match_mode": "match-all-rules",
      "position": 123,
      "repeat": true,
      "repeat_count": 123,
      "initial_delay": 123,
      "rules": [
        {
          "rule_type": "alert_urgency",
          "urgency_ids": "<array>"
        }
      ],
      "time_restriction_time_zone": "International Date Line West",
      "time_restrictions": [
        {
          "start_day": "monday",
          "start_time": "<string>",
          "end_day": "monday",
          "end_time": "<string>"
        }
      ]
    }
  }
}
'
{
  "data": {
    "id": "84135cb3-2365-45b8-8710-66723650bca8",
    "type": "escalation_paths",
    "attributes": {
      "name": "Et ut accusamus quo.",
      "default": false,
      "notification_type": "quiet",
      "escalation_policy_id": "07174ceb-0f93-425d-b157-5feaa57fc71d",
      "match_mode": "match-all-rules",
      "position": 1,
      "repeat": false,
      "repeat_count": 1,
      "initial_delay": 0,
      "time_restriction_time_zone": "America/New_York",
      "time_restrictions": [
        {
          "start_day": "monday",
          "start_time": "17:00",
          "end_day": "tuesday",
          "end_time": "07:00"
        },
        {
          "start_day": "wednesday",
          "start_time": "09:00",
          "end_day": "wednesday",
          "end_time": "20:00"
        }
      ],
      "created_at": "2026-02-13T12:59:31.282-08:00",
      "updated_at": "2026-02-13T12:59:31.951-08:00",
      "rules": [
        {
          "rule_type": "alert_urgency",
          "urgency_ids": [
            "fe4f1f37-79d2-41fa-9e41-3308feafe3cc"
          ]
        },
        {
          "rule_type": "field",
          "operator": "contains",
          "fieldable_type": "AlertField",
          "fieldable_id": "ed2680a5-963c-4239-85c0-73ea20845146",
          "values": [
            "database"
          ]
        }
      ]
    },
    "relationships": {
      "escalation_levels": {
        "data": []
      }
    }
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Body

application/vnd.api+json
data
object
required

Response

escalation policy updated

data
object
required