v2

latestSwagger 2.02026-07-26109144190.4 KB

Escalation Policies

Get a specific escalation policy

Gets a specific escalation policy based on the unique policy slug provided in the path.

The context for which team this policy belongs to is not available at this level. To retrieve information about this escalation policy's team, you must retrieve all of the policy summaries. The escalation policy summaries include links to this endpoint for each escalation policy.

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

get/api-public/v1/policies/{policy}

Path parameters

policystring required

The uniquely identifying escalation policy slug.

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

Headers

X-VO-Api-Idstring required

Your API ID

X-VO-Api-Keystring required

Your API Key

Response

The escalation policy matching the provided slug

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.