For AI agents and assistants: visit https://docs.pagerduty.com/llms.txt for the index.

Update an escalation policy

Updates an existing escalation policy and 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.write

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.

Header Parameters

Accept*string

The Accept header is used as a versioning header.

Default"application/vnd.pagerduty+json;version=2"

Request Body

application/json

The escalation policy to be updated.

TypeScript Definitions

Use the request body type in TypeScript.

escalation_policy*

Response Body

`application/json`

curl -X PUT "https://api.pagerduty.com/escalation_policies/{id}" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json" \  -d '{    "escalation_policy": {      "type": "escalation_policy",      "name": "Engineering Escalation Policy",      "escalation_rules": [        {          "escalation_delay_in_minutes": 30,          "targets": [            {              "id": "PEYSGVF",              "type": "user_reference"            }          ],          "escalation_rule_assignment_strategy": {            "type": "round_robin"          }        }      ],      "services": [        {          "id": "PIJ90N7",          "type": "service_reference"        }      ],      "num_loops": 2,      "on_call_handoff_notifications": "if_has_services",      "teams": [        {          "id": "PQ9K7I8",          "type": "team_reference"        }      ],      "description": "Here is the ep for the engineering team."    }  }'

{  "escalation_policy": {    "id": "PT20YPA",    "type": "escalation_policy",    "summary": "Another Escalation Policy",    "on_call_handoff_notifications": "if_has_services",    "self": "https://api.pagerduty.com/escalation_policies/PT20YPA",    "html_url": "https://subdomain.pagerduty.com/escalation_policies/PT20YPA",    "name": "Another Escalation Policy",    "escalation_rules": [      {        "id": "PGHDV41",        "escalation_delay_in_minutes": 30,        "targets": [          {            "id": "PAM4FGS",            "summary": "Kyler Kuhn",            "type": "user_reference",            "self": "https://api.pagerduty.com/users/PAM4FGS",            "html_url": "https://subdomain.pagerduty.com/users/PAM4FGS"          },          {            "id": "PI7DH85",            "summary": "Daily Engineering Rotation",            "type": "schedule_reference",            "self": "https://api.pagerduty.com/schedules/PI7DH85",            "html_url": "https://subdomain.pagerduty.com/schedules/PI7DH85"          }        ]      }    ],    "services": [      {        "id": "PIJ90N7",        "type": "service_reference",        "summary": "My Mail Service",        "self": "https://api.pagerduty.com/services/PIJ90N7",        "html_url": "https://subdomain.pagerduty.com/service-directory/PIJ90N7"      }    ],    "num_loops": 2,    "teams": [      {        "id": "PQ9K7I8",        "type": "team_reference",        "summary": "Engineering",        "self": "https://api.pagerduty.com/teams/PQ9K7I8",        "html_url": "https://subdomain.pagerduty.com/teams/PQ9K7I8"      }    ],    "description": "This is yet another escalation policy"  }}

Update an escalation policy

Authorization

Path Parameters

Header Parameters

Request Body

Response Body

200application/json

401application/json

402application/json

403application/json

404application/json

429application/json

Developer Agreement

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`