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": [
            "<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": "faec7247-f23b-4ec0-b2e2-980605bfbb40",
    "type": "escalation_paths",
    "attributes": {
      "name": "Test EP Path",
      "default": false,
      "notification_type": "quiet",
      "escalation_policy_id": "9bdfa0bd-3631-4ac4-8302-84b69562122b",
      "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-09-14T17:29:01.939-07:00",
      "updated_at": "2025-09-14T17:29:01.971-07:00",
      "rules": [
        {
          "rule_type": "alert_urgency",
          "urgency_ids": [
            "28764aad-c29d-4dc7-af9a-e7348a2858f9"
          ]
        },
        {
          "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

escalation path created

The response is of type object.