Skip to main content

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
namestringThe name of the escalation policy. (Required)
repeatintegerThe amount of times to repeat the escalation policy.
reassign_team_idsstring[]An array of Team IDs this escalation reassigns to.
reassign_account_user_idsstring[]An array of Account User IDs this escalation reassigns to.
team_idsstring[]The team IDs currently using this escalation policy.
escalation_layersEscalationLayer[]_id, , _id, , , _unit, _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