POST
/
v1
/
escalation_policies
/
{escalation_policy_id}
/
escalation_paths
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": [
            "<any>"
          ]
        }
      ],
      "time_restriction_time_zone": "International Date Line West",
      "time_restrictions": [
        {
          "start_day": "monday",
          "start_time": "<string>",
          "end_day": "monday",
          "end_time": "<string>"
        }
      ]
    }
  }
}'
{
  "data": {
    "id": "158cbdae-b9e2-49c2-91ae-3c0208aa923b",
    "type": "escalation_paths",
    "attributes": {
      "name": "Test EP Path",
      "default": false,
      "notification_type": "quiet",
      "escalation_policy_id": "fca863b6-a5d2-4069-95a6-2c4a3e31d4b8",
      "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": "2025-07-06T14:07:49.069-07:00",
      "updated_at": "2025-07-06T14:07:49.099-07:00",
      "rules": [
        {
          "rule_type": "alert_urgency",
          "urgency_ids": [
            "0c824a0e-72a5-4a9f-8a20-fd9372171441"
          ]
        },
        {
          "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

Response

201
application/vnd.api+json

escalation path created

The response is of type object.