Skip to main content
POST
/
v1
/
escalation_paths
/
{escalation_policy_path_id}
/
escalation_levels
Creates an escalation level for an Escalation Path
curl --request POST \
  --url https://api.rootly.com/v1/escalation_paths/{escalation_policy_path_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": "7dbbb510-ee7a-457d-b695-3c76e44641de",
    "type": "escalation_levels",
    "attributes": {
      "escalation_policy_path_id": "f7947ece-b2b7-4258-a8e5-6de37c48f6d4",
      "position": 2,
      "delay": 2,
      "escalation_policy_id": "fb03fe01-ec1b-4e05-9521-27320b30f2ff",
      "paging_strategy_configuration_strategy": null,
      "paging_strategy_configuration_schedule_strategy": null,
      "created_at": "2026-02-16T14:38:16.833-08:00",
      "updated_at": "2026-02-16T14:38:16.833-08:00",
      "notification_target_params": [
        {
          "id": "403",
          "type": "user",
          "team_members": "all"
        },
        {
          "id": "57ee0390-4a34-418f-8b4f-4e38a1949dd9",
          "type": "schedule",
          "team_members": "all"
        },
        {
          "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

escalation_policy_path_id
string
required

Body

application/vnd.api+json
data
object
required

Response

escalation level created

data
object
required