Escalation Policies

  • Escalation Policies define the rule set of how an Alert moves through a Team's on-call Schedule.

  • Escalation Policies are independent objects. The Team object is responsible for assigning itself a primary Schedule and an Escalation Policy.

The Escalation Policy Object

PropertyTypeDescription

name

string

The name of the escalation policy. (Required)

repeat

integer

The amount of times to repeat the escalation policy.

reassign_team_ids

string[]

An array of Team IDs this escalation reassigns to.

reassign_account_user_ids

string[]

An array of Account User IDs this escalation reassigns to.

team_ids

string[]

The team IDs currently using this escalation policy.

escalation_layers

:account_id, :id, :prefix_id, :layer, :timeout, :timeout_unit, :color_hex

Create a Escalation Policy

POST https://api.pagertree.com/api/v4/escalation_policies

Allowed Parameters

def escalation_policy_params
  params.permit(
    :name,
    :repeat,
    reassign_team_ids: [],
    reassign_account_user_ids: [],
    escalation_layers_attributes: [
      :id,
      :layer,
      :timeout,
      :timeout_unit,
      :color_hex,
      :_destroy
    ]
  )
end

Required Parameters

  • name

Retrieve an Escalation Policies

GET https://api.pagertree.com/api/v4/escalation_policies/:id

Update an Escalation Policies

PUT https://api.pagertree.com/api/v4/escalation_policies/:id

Delete an Escalation Policies

DELETE https://api.pagertree.com/api/v4/escalation_policies/:id

List all Escalation Policies

GET https://api.pagertree.com/api/v4/escalation_policies

Last updated