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

reassign_team_ids

string[]

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