get_escalation_policy
Read-onlyIdempotent
Retrieve details of a specific escalation policy by its ID. Returns policy rules, targets, and configuration.
Instructions
Get a specific escalation policy.
Args:
policy_id: The ID of the escalation policy to retrieve
Returns:
Escalation policy details
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| policy_id | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | The ID of the escalation policy | |
| name | Yes | The name of the escalation policy | |
| teams | No | The teams associated with this escalation policy | |
| summary | No | A short-form, server-generated string that provides succinct information about the escalation policy | |
| html_url | No | The URL at which this escalation policy is accessible in the PagerDuty UI | |
| self_url | No | The API URL at which this escalation policy is accessible | |
| services | No | The services that are using this escalation policy | |
| num_loops | No | The number of times the escalation policy will repeat after reaching the end of its escalation | |
| created_at | No | The date/time when this escalation policy was created | |
| updated_at | No | The date/time when this escalation policy was last updated | |
| description | No | The description of the escalation policy | |
| escalation_rules | Yes | The ordered list of escalation rules for the policy | |
| on_call_handoff_notifications | No | Determines how on call handoff notifications will be sent for users on theescalation policy | if_has_services |