Overview
Thelist_escalation_policies tool retrieves all escalation policies in your PagerDuty account with optional filtering capabilities. Escalation policies determine how incidents are escalated through various users and schedules when not acknowledged.
This is a read-only tool that does not modify any data in your PagerDuty account.
Parameters
Filter escalation policies by name or description. Performs a partial match search.Example:
"production"Filter escalation policies by user IDs. Only returns policies that include the specified users in their escalation rules.Example:
["P123ABC", "P456DEF"]Filter escalation policies by team IDs. Only returns policies associated with the specified teams.Example:
["TEAM123", "TEAM456"]Include additional details in the response. Available options:
services- Include services using this escalation policyteams- Include teams associated with this escalation policy
["services", "teams"]Maximum number of results to return. Must be between 1 and 100.Example:
50Response
Returns a list of escalation policy objects.Array of escalation policy objects
Example Usage
Use Cases
- Audit escalation paths - Review how incidents are escalated across your organization
- Find policies by team - Identify escalation policies associated with specific teams
- Discover user involvement - See which escalation policies include specific users
- Review policy configuration - Examine escalation timing and loop settings
Related Tools
- Get Escalation Policy - Retrieve a specific escalation policy by ID
- List On-Calls - See who is currently on-call
- List Services - View services and their escalation policies