Update a specific escalation path by id
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": "deb738aa-365d-4793-9a39-a8280cc4524b",
"type": "escalation_paths",
"attributes": {
"name": "Nemo quis dolore vitae.",
"default": false,
"notification_type": "quiet",
"escalation_policy_id": "864db336-4918-4a8e-b04c-efcfdbc9dace",
"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": "2025-12-05T05:22:26.985-08:00",
"updated_at": "2025-12-05T05:22:28.580-08:00",
"rules": [
{
"rule_type": "alert_urgency",
"urgency_ids": [
"abde0452-8f4c-4453-9046-e5b264f7ef34"
]
}
]
},
"relationships": {
"escalation_levels": {
"data": []
}
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Show child attributes
escalation_paths Show child attributes
The name of the escalation path
Position of the escalation policy level
audible, quiet Whether this escalation path is the default path
How path rules are matched.
match-all-rules, match-any-rule The position of this path in the paths for this EP.
Whether this path should be repeated until someone acknowledges the alert
The number of times this path will be executed until someone acknowledges the alert
Initial delay for escalation path in minutes. Maximum 1 week (10080).
Escalation path conditions
Time zone used for time restrictions.
International Date Line West, Etc/GMT+12, American Samoa, Pacific/Pago_Pago, Midway Island, Pacific/Midway, Hawaii, Pacific/Honolulu, Alaska, America/Juneau, Pacific Time (US & Canada), America/Los_Angeles, Tijuana, America/Tijuana, Arizona, America/Phoenix, Mazatlan, America/Mazatlan, Mountain Time (US & Canada), America/Denver, Central America, America/Guatemala, Central Time (US & Canada), America/Chicago, Chihuahua, America/Chihuahua, Guadalajara, America/Mexico_City, Mexico City, America/Mexico_City, Monterrey, America/Monterrey, Saskatchewan, America/Regina, Bogota, America/Bogota, Eastern Time (US & Canada), America/New_York, Indiana (East), America/Indiana/Indianapolis, Lima, America/Lima, Quito, America/Lima, Atlantic Time (Canada), America/Halifax, Caracas, America/Caracas, Georgetown, America/Guyana, La Paz, America/La_Paz, Puerto Rico, America/Puerto_Rico, Santiago, America/Santiago, Newfoundland, America/St_Johns, Asuncion, America/Asuncion, Brasilia, America/Sao_Paulo, Buenos Aires, America/Argentina/Buenos_Aires, Montevideo, America/Montevideo, Greenland, America/Nuuk, Mid-Atlantic, Atlantic/South_Georgia, Azores, Atlantic/Azores, Cape Verde Is., Atlantic/Cape_Verde, Casablanca, Africa/Casablanca, Dublin, Europe/Dublin, Edinburgh, Europe/London, Lisbon, Europe/Lisbon, London, Europe/London, Monrovia, Africa/Monrovia, UTC, Etc/UTC, Amsterdam, Europe/Amsterdam, Belgrade, Europe/Belgrade, Berlin, Europe/Berlin, Bern, Europe/Zurich, Bratislava, Europe/Bratislava, Brussels, Europe/Brussels, Budapest, Europe/Budapest, Copenhagen, Europe/Copenhagen, Ljubljana, Europe/Ljubljana, Madrid, Europe/Madrid, Paris, Europe/Paris, Prague, Europe/Prague, Rome, Europe/Rome, Sarajevo, Europe/Sarajevo, Skopje, Europe/Skopje, Stockholm, Europe/Stockholm, Vienna, Europe/Vienna, Warsaw, Europe/Warsaw, West Central Africa, Africa/Algiers, Zagreb, Europe/Zagreb, Zurich, Europe/Zurich, Athens, Europe/Athens, Bucharest, Europe/Bucharest, Cairo, Africa/Cairo, Harare, Africa/Harare, Helsinki, Europe/Helsinki, Jerusalem, Asia/Jerusalem, Kaliningrad, Europe/Kaliningrad, Kyiv, Europe/Kiev, Pretoria, Africa/Johannesburg, Riga, Europe/Riga, Sofia, Europe/Sofia, Tallinn, Europe/Tallinn, Vilnius, Europe/Vilnius, Baghdad, Asia/Baghdad, Istanbul, Europe/Istanbul, Kuwait, Asia/Kuwait, Minsk, Europe/Minsk, Moscow, Europe/Moscow, Nairobi, Africa/Nairobi, Riyadh, Asia/Riyadh, St. Petersburg, Europe/Moscow, Volgograd, Europe/Volgograd, Tehran, Asia/Tehran, Abu Dhabi, Asia/Muscat, Baku, Asia/Baku, Muscat, Asia/Muscat, Samara, Europe/Samara, Tbilisi, Asia/Tbilisi, Yerevan, Asia/Yerevan, Kabul, Asia/Kabul, Almaty, Asia/Almaty, Astana, Asia/Almaty, Ekaterinburg, Asia/Yekaterinburg, Islamabad, Asia/Karachi, Karachi, Asia/Karachi, Tashkent, Asia/Tashkent, Chennai, Asia/Kolkata, Kolkata, Asia/Kolkata, Mumbai, Asia/Kolkata, New Delhi, Asia/Kolkata, Sri Jayawardenepura, Asia/Colombo, Kathmandu, Asia/Kathmandu, Dhaka, Asia/Dhaka, Urumqi, Asia/Urumqi, Rangoon, Asia/Rangoon, Bangkok, Asia/Bangkok, Hanoi, Asia/Bangkok, Jakarta, Asia/Jakarta, Krasnoyarsk, Asia/Krasnoyarsk, Novosibirsk, Asia/Novosibirsk, Beijing, Asia/Shanghai, Chongqing, Asia/Chongqing, Hong Kong, Asia/Hong_Kong, Irkutsk, Asia/Irkutsk, Kuala Lumpur, Asia/Kuala_Lumpur, Perth, Australia/Perth, Singapore, Asia/Singapore, Taipei, Asia/Taipei, Ulaanbaatar, Asia/Ulaanbaatar, Osaka, Asia/Tokyo, Sapporo, Asia/Tokyo, Seoul, Asia/Seoul, Tokyo, Asia/Tokyo, Yakutsk, Asia/Yakutsk, Adelaide, Australia/Adelaide, Darwin, Australia/Darwin, Brisbane, Australia/Brisbane, Canberra, Australia/Canberra, Guam, Pacific/Guam, Hobart, Australia/Hobart, Melbourne, Australia/Melbourne, Port Moresby, Pacific/Port_Moresby, Sydney, Australia/Sydney, Vladivostok, Asia/Vladivostok, Magadan, Asia/Magadan, New Caledonia, Pacific/Noumea, Solomon Is., Pacific/Guadalcanal, Srednekolymsk, Asia/Srednekolymsk, Auckland, Pacific/Auckland, Fiji, Pacific/Fiji, Kamchatka, Asia/Kamchatka, Marshall Is., Pacific/Majuro, Wellington, Pacific/Auckland, Chatham Is., Pacific/Chatham, Nuku'alofa, Pacific/Tongatapu, Samoa, Pacific/Apia, Tokelau Is., Pacific/Fakaofo If time restrictions are set, alerts will follow this path when they arrive within the specified time ranges and meet the rules.
Show child attributes
monday, tuesday, wednesday, thursday, friday, saturday, sunday Formatted as HH:MM
monday, tuesday, wednesday, thursday, friday, saturday, sunday Formatted as HH:MM
escalation policy updated
Show child attributes
Unique ID of the escalation policy path
Show child attributes
The name of the escalation path
Whether this escalation path is the default path
Notification rule type
The ID of the escalation policy
Whether this path should be repeated until someone acknowledges the alert
The number of times this path will be executed until someone acknowledges the alert
How path rules are matched.
match-all-rules, match-any-rule The position of this path in the paths for this EP.
Initial delay for escalation path in minutes. Maximum 1 week (10080).
Date of creation
Date of last update
Escalation path rules
Time zone used for time restrictions.
International Date Line West, Etc/GMT+12, American Samoa, Pacific/Pago_Pago, Midway Island, Pacific/Midway, Hawaii, Pacific/Honolulu, Alaska, America/Juneau, Pacific Time (US & Canada), America/Los_Angeles, Tijuana, America/Tijuana, Arizona, America/Phoenix, Mazatlan, America/Mazatlan, Mountain Time (US & Canada), America/Denver, Central America, America/Guatemala, Central Time (US & Canada), America/Chicago, Chihuahua, America/Chihuahua, Guadalajara, America/Mexico_City, Mexico City, America/Mexico_City, Monterrey, America/Monterrey, Saskatchewan, America/Regina, Bogota, America/Bogota, Eastern Time (US & Canada), America/New_York, Indiana (East), America/Indiana/Indianapolis, Lima, America/Lima, Quito, America/Lima, Atlantic Time (Canada), America/Halifax, Caracas, America/Caracas, Georgetown, America/Guyana, La Paz, America/La_Paz, Puerto Rico, America/Puerto_Rico, Santiago, America/Santiago, Newfoundland, America/St_Johns, Asuncion, America/Asuncion, Brasilia, America/Sao_Paulo, Buenos Aires, America/Argentina/Buenos_Aires, Montevideo, America/Montevideo, Greenland, America/Nuuk, Mid-Atlantic, Atlantic/South_Georgia, Azores, Atlantic/Azores, Cape Verde Is., Atlantic/Cape_Verde, Casablanca, Africa/Casablanca, Dublin, Europe/Dublin, Edinburgh, Europe/London, Lisbon, Europe/Lisbon, London, Europe/London, Monrovia, Africa/Monrovia, UTC, Etc/UTC, Amsterdam, Europe/Amsterdam, Belgrade, Europe/Belgrade, Berlin, Europe/Berlin, Bern, Europe/Zurich, Bratislava, Europe/Bratislava, Brussels, Europe/Brussels, Budapest, Europe/Budapest, Copenhagen, Europe/Copenhagen, Ljubljana, Europe/Ljubljana, Madrid, Europe/Madrid, Paris, Europe/Paris, Prague, Europe/Prague, Rome, Europe/Rome, Sarajevo, Europe/Sarajevo, Skopje, Europe/Skopje, Stockholm, Europe/Stockholm, Vienna, Europe/Vienna, Warsaw, Europe/Warsaw, West Central Africa, Africa/Algiers, Zagreb, Europe/Zagreb, Zurich, Europe/Zurich, Athens, Europe/Athens, Bucharest, Europe/Bucharest, Cairo, Africa/Cairo, Harare, Africa/Harare, Helsinki, Europe/Helsinki, Jerusalem, Asia/Jerusalem, Kaliningrad, Europe/Kaliningrad, Kyiv, Europe/Kiev, Pretoria, Africa/Johannesburg, Riga, Europe/Riga, Sofia, Europe/Sofia, Tallinn, Europe/Tallinn, Vilnius, Europe/Vilnius, Baghdad, Asia/Baghdad, Istanbul, Europe/Istanbul, Kuwait, Asia/Kuwait, Minsk, Europe/Minsk, Moscow, Europe/Moscow, Nairobi, Africa/Nairobi, Riyadh, Asia/Riyadh, St. Petersburg, Europe/Moscow, Volgograd, Europe/Volgograd, Tehran, Asia/Tehran, Abu Dhabi, Asia/Muscat, Baku, Asia/Baku, Muscat, Asia/Muscat, Samara, Europe/Samara, Tbilisi, Asia/Tbilisi, Yerevan, Asia/Yerevan, Kabul, Asia/Kabul, Almaty, Asia/Almaty, Astana, Asia/Almaty, Ekaterinburg, Asia/Yekaterinburg, Islamabad, Asia/Karachi, Karachi, Asia/Karachi, Tashkent, Asia/Tashkent, Chennai, Asia/Kolkata, Kolkata, Asia/Kolkata, Mumbai, Asia/Kolkata, New Delhi, Asia/Kolkata, Sri Jayawardenepura, Asia/Colombo, Kathmandu, Asia/Kathmandu, Dhaka, Asia/Dhaka, Urumqi, Asia/Urumqi, Rangoon, Asia/Rangoon, Bangkok, Asia/Bangkok, Hanoi, Asia/Bangkok, Jakarta, Asia/Jakarta, Krasnoyarsk, Asia/Krasnoyarsk, Novosibirsk, Asia/Novosibirsk, Beijing, Asia/Shanghai, Chongqing, Asia/Chongqing, Hong Kong, Asia/Hong_Kong, Irkutsk, Asia/Irkutsk, Kuala Lumpur, Asia/Kuala_Lumpur, Perth, Australia/Perth, Singapore, Asia/Singapore, Taipei, Asia/Taipei, Ulaanbaatar, Asia/Ulaanbaatar, Osaka, Asia/Tokyo, Sapporo, Asia/Tokyo, Seoul, Asia/Seoul, Tokyo, Asia/Tokyo, Yakutsk, Asia/Yakutsk, Adelaide, Australia/Adelaide, Darwin, Australia/Darwin, Brisbane, Australia/Brisbane, Canberra, Australia/Canberra, Guam, Pacific/Guam, Hobart, Australia/Hobart, Melbourne, Australia/Melbourne, Port Moresby, Pacific/Port_Moresby, Sydney, Australia/Sydney, Vladivostok, Asia/Vladivostok, Magadan, Asia/Magadan, New Caledonia, Pacific/Noumea, Solomon Is., Pacific/Guadalcanal, Srednekolymsk, Asia/Srednekolymsk, Auckland, Pacific/Auckland, Fiji, Pacific/Fiji, Kamchatka, Asia/Kamchatka, Marshall Is., Pacific/Majuro, Wellington, Pacific/Auckland, Chatham Is., Pacific/Chatham, Nuku'alofa, Pacific/Tongatapu, Samoa, Pacific/Apia, Tokelau Is., Pacific/Fakaofo If time restrictions are set, alerts will follow this path when they arrive within the specified time ranges and meet the rules.
Show child attributes
monday, tuesday, wednesday, thursday, friday, saturday, sunday Formatted as HH:MM
monday, tuesday, wednesday, thursday, friday, saturday, sunday Formatted as HH:MM
escalation_paths Was this page helpful?
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": "deb738aa-365d-4793-9a39-a8280cc4524b",
"type": "escalation_paths",
"attributes": {
"name": "Nemo quis dolore vitae.",
"default": false,
"notification_type": "quiet",
"escalation_policy_id": "864db336-4918-4a8e-b04c-efcfdbc9dace",
"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": "2025-12-05T05:22:26.985-08:00",
"updated_at": "2025-12-05T05:22:28.580-08:00",
"rules": [
{
"rule_type": "alert_urgency",
"urgency_ids": [
"abde0452-8f4c-4453-9046-e5b264f7ef34"
]
}
]
},
"relationships": {
"escalation_levels": {
"data": []
}
}
}
}