Creates a new escalation level from provided data
curl --request POST \
--url https://api.rootly.com/v1/escalation_policies/{escalation_policy_id}/escalation_levels \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "escalation_levels",
"attributes": {
"position": 123,
"notification_target_params": [
{
"id": "<string>",
"type": "team",
"team_members": "all"
}
],
"delay": 123,
"paging_strategy_configuration_strategy": "default",
"paging_strategy_configuration_schedule_strategy": "on_call_only",
"escalation_policy_path_id": "<string>"
}
}
}
'{
"data": {
"id": "4900a272-0825-4b0d-8420-82a8e9f0cde4",
"type": "escalation_levels",
"attributes": {
"escalation_policy_path_id": "93e7532e-ce24-41a9-b713-006525c12a6c",
"position": 1,
"delay": 2,
"escalation_policy_id": "c8e4994e-31a5-48ce-aec6-10bdbf3210c0",
"paging_strategy_configuration_strategy": null,
"paging_strategy_configuration_schedule_strategy": null,
"created_at": "2025-12-05T15:06:11.276-08:00",
"updated_at": "2025-12-05T15:06:11.276-08:00",
"notification_target_params": [
{
"id": "158",
"type": "user",
"team_members": "all"
},
{
"id": "0e6e8fe7-1d5e-4214-82c4-b29ec55fd539",
"type": "schedule",
"team_members": "all"
},
{
"id": "CX21345",
"type": "slack_channel",
"team_members": "all"
}
]
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Show child attributes
escalation_levels Show child attributes
Position of the escalation policy level
Escalation level's notification targets
Show child attributes
The ID of notification target. If Slack channel, then id of the slack channel (eg. C06Q2JK7RQW)
The type of the notification target
team, user, schedule, slack_channel, service For targets with type=team, controls whether to notify admins, all team members, or escalate to team EP.
all, admins, escalate Delay before notification targets will be alerted.
default, random, cycle, alert on_call_only, everyone 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.
escalation level created
Show child attributes
Unique ID of the escalation policy level
Show child attributes
The ID of the escalation policy
Delay before notification targets will be alerted.
Position of the escalation policy level
Escalation level's notification targets
Show child attributes
The ID of notification target
The type of the notification target
team, user, schedule, slack_channel, service For targets with type=team, controls whether to notify admins, all team members, or escalate to team EP.
all, admins, escalate 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.
default, random, cycle, alert on_call_only, everyone Date of creation
Date of last update
escalation_levels Was this page helpful?
curl --request POST \
--url https://api.rootly.com/v1/escalation_policies/{escalation_policy_id}/escalation_levels \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "escalation_levels",
"attributes": {
"position": 123,
"notification_target_params": [
{
"id": "<string>",
"type": "team",
"team_members": "all"
}
],
"delay": 123,
"paging_strategy_configuration_strategy": "default",
"paging_strategy_configuration_schedule_strategy": "on_call_only",
"escalation_policy_path_id": "<string>"
}
}
}
'{
"data": {
"id": "4900a272-0825-4b0d-8420-82a8e9f0cde4",
"type": "escalation_levels",
"attributes": {
"escalation_policy_path_id": "93e7532e-ce24-41a9-b713-006525c12a6c",
"position": 1,
"delay": 2,
"escalation_policy_id": "c8e4994e-31a5-48ce-aec6-10bdbf3210c0",
"paging_strategy_configuration_strategy": null,
"paging_strategy_configuration_schedule_strategy": null,
"created_at": "2025-12-05T15:06:11.276-08:00",
"updated_at": "2025-12-05T15:06:11.276-08:00",
"notification_target_params": [
{
"id": "158",
"type": "user",
"team_members": "all"
},
{
"id": "0e6e8fe7-1d5e-4214-82c4-b29ec55fd539",
"type": "schedule",
"team_members": "all"
},
{
"id": "CX21345",
"type": "slack_channel",
"team_members": "all"
}
]
}
}
}