Skip to main content
POST
/
v1
/
escalation_policies
/
{escalation_policy_id}
/
escalation_paths
Creates an escalation path
curl --request POST \
  --url https://api.rootly.com/v1/escalation_policies/{escalation_policy_id}/escalation_paths \
  --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": "67845e39-4cfa-4399-a7b5-e2d2ebc58146",
    "type": "escalation_paths",
    "attributes": {
      "name": "Test EP Path",
      "default": false,
      "notification_type": "quiet",
      "escalation_policy_id": "c2f19e56-efe7-4253-9765-639084104f7b",
      "match_mode": "match-all-rules",
      "position": 1,
      "repeat": true,
      "repeat_count": 3,
      "initial_delay": 0,
      "time_restriction_time_zone": "America/Los_Angeles",
      "time_restrictions": [
        {
          "start_day": "monday",
          "start_time": "17:00",
          "end_day": "tuesday",
          "end_time": "07:00"
        },
        {
          "start_day": "wednesday",
          "start_time": "07:00",
          "end_day": "wednesday",
          "end_time": "17:00"
        }
      ],
      "created_at": "2026-01-03T21:26:15.254-08:00",
      "updated_at": "2026-01-03T21:26:15.275-08:00",
      "rules": [
        {
          "rule_type": "alert_urgency",
          "urgency_ids": [
            "42817bd7-4f0f-4528-9e71-96a88c88a454"
          ]
        },
        {
          "rule_type": "working_hour",
          "within_working_hour": true
        },
        {
          "rule_type": "json_path",
          "json_path": "$.title",
          "operator": "is",
          "value": "Test"
        }
      ]
    },
    "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

escalation_policy_id
string
required

Body

application/vnd.api+json
data
object
required

Response

escalation path created

data
object
required