Update an escalation level

curl --request PUT \ --url https://api.rootly.com/v1/escalation_levels/{id} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/vnd.api+json' \ --data '{ "data": { "type": "escalation_levels", "attributes": { "delay": 123, "position": 123, "escalation_policy_path_id": "<string>", "paging_strategy_configuration_strategy": "default", "paging_strategy_configuration_schedule_strategy": "on_call_only", "notification_target_params": [ { "id": "<string>", "type": "team", "team_members": "all" } ] } } }'

{ "data": { "id": "47409cbc-1854-44a9-b28b-56f98c52a61f", "type": "escalation_levels", "attributes": { "escalation_policy_path_id": null, "position": 1, "delay": 5, "escalation_policy_id": "3786f2a9-777c-42ca-b68b-eb8ebd37043b", "paging_strategy_configuration_strategy": null, "paging_strategy_configuration_schedule_strategy": null, "created_at": "2025-11-26T20:52:31.959-08:00", "updated_at": "2025-11-26T20:52:31.959-08:00", "notification_target_params": [ { "id": "CX21345", "type": "slack_channel", "team_members": "all" } ] } } }

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Body

application/vnd.api+json

data

object

required

Show child attributes

data.type

enum<string>

required

Available options:

escalation_levels

data.attributes

object

required

Show child attributes

data.attributes.delay

integer

Delay before notification targets will be alerted.

data.attributes.position

integer

Position of the escalation policy level

data.attributes.escalation_policy_path_id

string | null

The ID of the dynamic escalation policy path the level will belong to. If nothing is specified it will add the level to your default path.

data.attributes.paging_strategy_configuration_strategy

enum<string> | null

Available options:

default,

random,

cycle,

alert

data.attributes.paging_strategy_configuration_schedule_strategy

enum<string> | null

Available options:

on_call_only,

everyone

data.attributes.notification_target_params

(object | null)[]

Escalation level's notification targets

Show child attributes

data.attributes.notification_target_params.id

string

required

The ID of notification target

data.attributes.notification_target_params.type

enum<string>

required

The type of the notification target

Available options:

team,

user,

schedule,

slack_channel,

service

data.attributes.notification_target_params.team_members

enum<string> | null

For targets with type=team, controls whether to notify admins, all team members, or escalate to team EP.

Available options:

all,

admins,

escalate

Response

escalation policy updated with notification_target set with slack_channel_id instead of slack_channel uuid

data

object

required

Show child attributes

data.id

string

required

Unique ID of the escalation policy level

data.attributes

object

required

Show child attributes

data.attributes.escalation_policy_id

string

required

The ID of the escalation policy

data.attributes.delay

integer

required

Delay before notification targets will be alerted.

data.attributes.position

integer

required

Position of the escalation policy level

data.attributes.notification_target_params

(object | null)[]

required

Escalation level's notification targets

Show child attributes

data.attributes.notification_target_params.id

string

required

The ID of notification target

data.attributes.notification_target_params.type

enum<string>

required

The type of the notification target

Available options:

team,

user,

schedule,

slack_channel,

service

data.attributes.notification_target_params.team_members

enum<string> | null

For targets with type=team, controls whether to notify admins, all team members, or escalate to team EP.

Available options:

all,

admins,

escalate

data.attributes.escalation_policy_path_id

string | null

The ID of the dynamic escalation policy path the level will belong to. If nothing is specified it will add the level to your default path.

data.attributes.paging_strategy_configuration_strategy

enum<string> | null

Available options:

default,

random,

cycle,

alert

data.attributes.paging_strategy_configuration_schedule_strategy

enum<string> | null

Available options:

on_call_only,

everyone

data.attributes.created_at

string

Date of creation

data.attributes.updated_at

string

Date of last update

data.type

enum<string>

Available options:

escalation_levels

Overview

AlertEvents

AlertFields

AlertGroups

AlertRoutes

AlertRoutingRules

AlertUrgencies

AlertSources

Alerts

Audits

Authorizations

CatalogEntities

CatalogEntityProperties

CatalogFields

Catalogs

Causes

Communications Groups

Communications Stages

Communications Templates

Communications Types

[DEPRECATED] CustomFieldOptions

[DEPRECATED] CustomFields

CustomForms

DashboardPanels

Dashboards

Environments

EscalationPolicies

EscalationLevelsPolicies

EscalationLevelsPath

EscalationLevels

EscalationPaths

FormFieldOptions

FormFieldPlacementConditions

FormFieldPlacements

FormFieldPositions

FormFields

FormSetConditions

FormSets

Functionalities

WorkflowTasks

[DEPRECATED] WorkflowCustomFieldSelections

WorkflowFormFieldConditions

WorkflowGroups

WorkflowRuns

Workflows

Heartbeats

IncidentActionItems

[DEPRECATED] IncidentCustomFieldSelections

IncidentEventFunctionalities

IncidentEventServices

IncidentEvents

IncidentFeedbacks

IncidentFormFieldSelections

IncidentPermissionSetBooleans

IncidentPermissionSetResources

IncidentPermissionSets

IncidentRetrospectives

IncidentRetrospectiveSteps

IncidentRoleTasks

IncidentRoles

IncidentStatusPageEvents

IncidentSubStatuses

IncidentTypes

Incidents

IpRanges

LiveCallRouters

OnCallRoles

OnCallShadows

OverrideShifts

PlaybookTasks

Playbooks

RetrospectiveTemplates

Pulses

RetrospectiveConfigurations

RetrospectiveProcessGroupSteps

RetrospectiveProcessGroups

RetrospectiveProcesses

RetrospectiveSteps

Roles

ScheduleRotationActiveDays