pagerduty-api — quality + safety report

---
name: pagerduty-api
description: "PagerDuty API skill. Use when working with PagerDuty for {entity_type}, abilities, addons. Covers 391 endpoints."
version: 1.0.0
generator: lapsh
---

# PagerDuty API
API version: 2.0.0

## Auth
ApiKey Authorization in header

## Base URL
https://api.pagerduty.com

## Setup
1. Set your API key in the appropriate header
2. GET /abilities -- verify access
3. POST /{entity_type}/{id}/change_tags -- create first change_tags

## Endpoints

391 endpoints across 39 groups. See references/api-spec.lap for full details.

### {entity_type}
| Method | Path | Description |
|--------|------|-------------|
| POST | /{entity_type}/{id}/change_tags | Assign tags |
| GET | /{entity_type}/{id}/tags | Get tags for entities |

### abilities
| Method | Path | Description |
|--------|------|-------------|
| GET | /abilities | List abilities |
| GET | /abilities/{id} | Test an ability |

### addons
| Method | Path | Description |
|--------|------|-------------|
| GET | /addons | List installed Add-ons |
| POST | /addons | Install an Add-on |
| GET | /addons/{id} | Get an Add-on |
| DELETE | /addons/{id} | Delete an Add-on |
| PUT | /addons/{id} | Update an Add-on |

### alert_grouping_settings
| Method | Path | Description |
|--------|------|-------------|
| GET | /alert_grouping_settings | List alert grouping settings |
| POST | /alert_grouping_settings | Create an Alert Grouping Setting |
| GET | /alert_grouping_settings/{id} | Get an Alert Grouping Setting |
| DELETE | /alert_grouping_settings/{id} | Delete an Alert Grouping Setting |
| PUT | /alert_grouping_settings/{id} | Update an Alert Grouping Setting |

### analytics
| Method | Path | Description |
|--------|------|-------------|
| POST | /analytics/metrics/incidents/all | Get aggregated incident data |
| POST | /analytics/metrics/incidents/escalation_policies | Get aggregated escalation policy data |
| POST | /analytics/metrics/incidents/escalation_policies/all | Get aggregated metrics for all escalation policies |
| POST | /analytics/metrics/incidents/services | Get aggregated service data |
| POST | /analytics/metrics/incidents/services/all | Get aggregated metrics for all services |
| POST | /analytics/metrics/incidents/teams | Get aggregated team data |
| POST | /analytics/metrics/incidents/teams/all | Get aggregated metrics for all teams |
| POST | /analytics/metrics/pd_advance_usage/features | Get aggregated PD Advance usage data |
| POST | /analytics/metrics/responders/all | Get aggregated metrics for all responders |
| POST | /analytics/metrics/responders/teams | Get responder data aggregated by team |
| POST | /analytics/metrics/users/all | Get aggregated metrics for all users |
| POST | /analytics/raw/incidents | Get raw data - multiple incidents |
| GET | /analytics/raw/incidents/{id} | Get raw data - single incident |
| GET | /analytics/raw/incidents/{id}/responses | Get raw responses from a single incident |
| POST | /analytics/raw/responders/{responder_id}/incidents | Get raw incidents for a single responder_id |
| POST | /analytics/raw/users | Get raw user analytics data |

### audit
| Method | Path | Description |
|--------|------|-------------|
| GET | /audit/records | List audit records |

### automation_actions
| Method | Path | Description |
|--------|------|-------------|
| POST | /automation_actions/actions | Create an Automation Action |
| GET | /automation_actions/actions | List Automation Actions |
| GET | /automation_actions/actions/{id} | Get an Automation Action |
| DELETE | /automation_actions/actions/{id} | Delete an Automation Action |
| PUT | /automation_actions/actions/{id} | Update an Automation Action |
| POST | /automation_actions/actions/{id}/invocations | Create an Invocation |
| GET | /automation_actions/actions/{id}/services | Get all service references associated with an Automation Action |
| POST | /automation_actions/actions/{id}/services | Associate an Automation Action with a service |
| GET | /automation_actions/actions/{id}/services/{service_id} | Get the details of an Automation Action / service relation |
| DELETE | /automation_actions/actions/{id}/services/{service_id} | Disassociate an Automation Action from a service |
| POST | /automation_actions/actions/{id}/teams | Associate an Automation Action with a team |
| GET | /automation_actions/actions/{id}/teams | Get all team references associated with an Automation Action |
| DELETE | /automation_actions/actions/{id}/teams/{team_id} | Disassociate an Automation Action from a team |
| GET | /automation_actions/actions/{id}/teams/{team_id} | Get the details of an Automation Action / team relation |
| GET | /automation_actions/invocations | List Invocations |
| GET | /automation_actions/invocations/{id} | Get an Invocation |
| POST | /automation_actions/runners | Create an Automation Action runner. |
| GET | /automation_actions/runners | List Automation Action runners |
| GET | /automation_actions/runners/{id} | Get an Automation Action runner |
| PUT | /automation_actions/runners/{id} | Update an Automation Action runner |
| DELETE | /automation_actions/runners/{id} | Delete an Automation Action runner |
| POST | /automation_actions/runners/{id}/teams | Associate a runner with a team |
| GET | /automation_actions/runners/{id}/teams | Get all team references associated with a runner |
| DELETE | /automation_actions/runners/{id}/teams/{team_id} | Disassociate a runner from a team |
| GET | /automation_actions/runners/{id}/teams/{team_id} | Get the details of a runner / team relation |

### business_services
| Method | Path | Description |
|--------|------|-------------|
| GET | /business_services | List Business Services |
| POST | /business_services | Create a Business Service |
| GET | /business_services/{id} | Get a Business Service |
| DELETE | /business_services/{id} | Delete a Business Service |
| PUT | /business_services/{id} | Update a Business Service |
| POST | /business_services/{id}/account_subscription | Create Business Service Account Subscription |
| DELETE | /business_services/{id}/account_subscription | Delete Business Service Account Subscription |
| GET | /business_services/{id}/subscribers | List Business Service Subscribers |
| POST | /business_services/{id}/subscribers | Create Business Service Subscribers |
| GET | /business_services/{id}/supporting_services/impacts | List the supporting Business Services for the given Business Service Id, sorted by impacted status. |
| POST | /business_services/{id}/unsubscribe | Remove Business Service Subscribers |
| GET | /business_services/impactors | List Impactors affecting Business Services |
| GET | /business_services/impacts | List Business Services sorted by impacted status |
| GET | /business_services/priority_thresholds | Get the global priority threshold for a Business Service to be considered impacted by an Incident |
| DELETE | /business_services/priority_thresholds | Deletes the account-level priority threshold for Business Service impact |
| PUT | /business_services/priority_thresholds | Set the Account-level priority threshold for Business Service impact. |

### change_events
| Method | Path | Description |
|--------|------|-------------|
| GET | /change_events | List Change Events |
| POST | /change_events | Create a Change Event |
| GET | /change_events/{id} | Get a Change Event |
| PUT | /change_events/{id} | Update a Change Event |

### escalation_policies
| Method | Path | Description |
|--------|------|-------------|
| GET | /escalation_policies | List escalation policies |
| POST | /escalation_policies | Create an escalation policy |
| GET | /escalation_policies/{id} | Get an escalation policy |
| DELETE | /escalation_policies/{id} | Delete an escalation policy |
| PUT | /escalation_policies/{id} | Update an escalation policy |
| GET | /escalation_policies/{id}/audit/records | List audit records for an escalation policy |

### event_orchestrations
| Method | Path | Description |
|--------|------|-------------|
| GET | /event_orchestrations | List Event Orchestrations |
| POST | /event_orchestrations | Create an Orchestration |
| GET | /event_orchestrations/{id} | Get an Orchestration |
| PUT | /event_orchestrations/{id} | Update an Orchestration |
| DELETE | /event_orchestrations/{id} | Delete an Orchestration |
| GET | /event_orchestrations/{id}/integrations | List Integrations for an Event Orchestration |
| POST | /event_orchestrations/{id}/integrations | Create an Integration for an Event Orchestration |
| GET | /event_orchestrations/{id}/integrations/{integration_id} | Get an Integration for an Event Orchestration |
| PUT | /event_orchestrations/{id}/integrations/{integration_id} | Update an Integration for an Event Orchestration |
| DELETE | /event_orchestrations/{id}/integrations/{integration_id} | Delete an Integration for an Event Orchestration |
| POST | /event_orchestrations/{id}/integrations/migration | Migrate an Integration from one Event Orchestration to another |
| GET | /event_orchestrations/{id}/global | Get the Global Orchestration for an Event Orchestration |
| PUT | /event_orchestrations/{id}/global | Update the Global Orchestration for an Event Orchestration |
| GET | /event_orchestrations/{id}/router | Get the Router for an Event Orchestration |
| PUT | /event_orchestrations/{id}/router | Update the Router for an Event Orchestration |
| GET | /event_orchestrations/{id}/unrouted | Get the Unrouted Orchestration for an Event Orchestration |
| PUT | /event_orchestrations/{id}/unrouted | Update the Unrouted Orchestration for an Event Orchestration |
| GET | /event_orchestrations/services/{service_id} | Get the Service Orchestration for a Service |
| PUT | /event_orchestrations/services/{service_id} | Update the Service Orchestration for a Service |
| GET | /event_orchestrations/services/{service_id}/active | Get the Service Orchestration active status for a Service |
| PUT | /event_orchestrations/services/{service_id}/active | Update the Service Orchestration active status for a Service |
| GET | /event_orchestrations/{id}/cache_variables | List Cache Variables for a Global Event Orchestration |
| POST | /event_orchestrations/{id}/cache_variables | Create a Cache Variable for a Global Event Orchestration |
| GET | /event_orchestrations/{id}/cache_variables/{cache_variable_id} | Get a Cache Variable for a Global Event Orchestration |
| PUT | /event_orchestrations/{id}/cache_variables/{cache_variable_id} | Update a Cache Variable for a Global Event Orchestration |
| DELETE | /event_orchestrations/{id}/cache_variables/{cache_variable_id} | Delete a Cache Variable for a Global Event Orchestration |
| GET | /event_orchestrations/{id}/cache_variables/{cache_variable_id}/data | Get Data for an External Data Cache Variable on a Global Event Orchestration |
| PUT | /event_orchestrations/{id}/cache_variables/{cache_variable_id}/data | Update Data for an External Data Cache Variable on a Global Event Orchestration |
| DELETE | /event_orchestrations/{id}/cache_variables/{cache_variable_id}/data | Delete Data for an External Data Cache Variable on a Global Event Orchestration |
| GET | /event_orchestrations/services/{service_id}/cache_variables | List Cache Variables for a Service Event Orchestration |
| POST | /event_orchestrations/services/{service_id}/cache_variables | Create a Cache Variable for a Service Event Orchestration |
| GET | /event_orchestrations/services/{service_id}/cache_variables/{cache_variable_id} | Get a Cache Variable for a Service Event Orchestration |
| PUT | /event_orchestrations/services/{service_id}/cache_variables/{cache_variable_id} | Update a Cache Variable for a Service Event Orchestration |
| DELETE | /event_orchestrations/services/{service_id}/cache_variables/{cache_variable_id} | Delete a Cache Variable for a Service Event Orchestration |
| GET | /event_orchestrations/services/{service_id}/cache_variables/{cache_variable_id}/data | Get Data for an External Data Cache Variable on a

… (truncated)