|docs
Start Trial
REST APIEscalation policies

Get an escalation policy

Get information about an existing escalation policy and its rules.

Escalation policies define which user should be alerted at which time.

For more information see the API Concepts Document

Scoped OAuth requires: escalation_policies.read

Authorization

api_key
Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Path Parameters

id*string

The ID of the resource.

Query Parameters

include[]?string

Array of additional Models to include in response.

Value in

  • "services"
  • "teams"
  • "targets"
  • "escalation_rule_assignment_strategies"

Header Parameters

Accept*string

The Accept header is used as a versioning header.

Default"application/vnd.pagerduty+json;version=2"
Content-Type*"application/json"
Default"application/json"

Value in

  • "application/json"

Response Body

application/json

application/json

application/json

application/json

Delete an escalation policy DELETE

Deletes an existing escalation policy and rules. The escalation policy must not be in use by any services. Escalation policies define which user should be alerted at which time. For more information see the [API Concepts Document](https://developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#escalation-policies) Scoped OAuth requires: `escalation_policies.write`

List escalation policies GET

List all of the existing escalation policies. Escalation policies define which user should be alerted at which time. For more information see the [API Concepts Document](https://developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#escalation-policies) Scoped OAuth requires: `escalation_policies.read`