Sign in

v2

latestSwagger 2.02026-07-26109144190.4 KB
Escalation Policies

Create an escalation policy

Takes an entire escalation policy and creates it.

For the purpose of using this API, escalation policies are treated as immutable. The policy will not be able to be updated or modified in any way via this API once created. It will only be able to be deleted. However, The escalation policies are accessable in the UI once created and can be updated from there.

This API may be called a maximum of 2 times per second.

post/api-public/v1/policies

Headers

X-VO-Api-Idstring required

Your API ID

X-VO-Api-Keystring required

Your API Key

Request body

namestring required

The name of the escalation policy

teamSlugstring required

The unique identifier for the team to create the policy under.

The team slug is in the format team-[\w\d]{16}

ignoreCustomPagingPoliciesboolean

True if this policy ignores a user's custom paging policy; this will page the on-call user via their Primary Paging Policy and ignore any custom paging policies they have set. We recommend enabling this if the escalation policy handles high severity incidents.

Response

The newly created escalation policy

namestring required

The name of this escalation policy

slugstring required

A unique identifier for this escalation polcy

This slug is in the format pol-[\w\d]{16}

ignoreCustomPagingPoliciesboolean required

True if this policy ignores a user's custom paging policy; this will page the on-call user via their Primary Paging Policy and ignore any custom paging policies they have set. We recommend enabling this if the escalation policy handles high severity incidents.