# PagerDuty on boxd

> PagerDuty helps you proactively manage your digital operations by collecting data signals from anywhere, interpreting those signals using machine learning, automatically engaging the right people, and accelerating resolution and learning.

- Page: https://boxd.sh/integrations/pagerduty/
- CLI: `run pagerduty` (368 commands, 8 marked common)
- SDK: `import { pagerduty } from "@boxd/run"`; every parameter and response type is at `@boxd/run/pagerduty`
- Triggers: none
- Connect: `run auth pagerduty` (Sign in with PagerDuty), or https://app.boxd.sh/integrations/detail/pagerduty
- All integrations: https://boxd.sh/integrations/ (Markdown: https://boxd.sh/integrations/index.md)

## From the shell

```sh
run auth pagerduty      # once: prints a link to connect your account
run pagerduty           # list its commands
run pagerduty fetch-incident-list
```

Parameters are flags (`--flag value`); object and array parameters take a JSON string. Output is YAML, or JSON with `--json`. Calls use your own connection; `--scope <name>` uses a connection shared with your team.

## From a script

```ts
import { every, pagerduty } from "@boxd/run";

every("1 hour", async () => {
  const result = await pagerduty.fetchIncidentList({});
  console.log(result);
});
```

Run it with `run pagerduty.run.ts`. PagerDuty has no triggers; `every()` polls on a schedule, keeps the script running as a job, and wakes the machine when it is due.

## Commands

Required flags are listed; `run pagerduty <command> --help` lists the optional ones. "common" marks what `run pagerduty` shows without `--all`.

| Command | SDK method | Required flags | Optional | Description |
|---|---|---|---|---|
| `add-service-to-incident-workflow-trigger` | `pagerduty.addServiceToIncidentWorkflowTrigger()` | `--id` `--service--id` | 0 | Adds a service to an existing incident workflow trigger in PagerDuty, enabling the trigger to fire for incidents on that service |
| `aggregate-escalation-policy-incident-metrics` | `pagerduty.aggregateEscalationPolicyIncidentMetrics()` | — | 17 | This endpoint analyzes and aggregates incident metrics across all escalation policies in PagerDuty |
| `aggregate-incident-metrics-with-filters` | `pagerduty.aggregateIncidentMetricsWithFilters()` | — | 17 | Retrieves and aggregates metrics for incidents across all services in PagerDuty |
| `associate-service-dependencies` | `pagerduty.associateServiceDependencies()` | — | 1 | Associates multiple service dependencies in PagerDuty, allowing you to define relationships between supporting and dependent services |
| `associate-team-with-automation-action` | `pagerduty.associateTeamWithAutomationAction()` | `--id` `--team` | 0 | This endpoint associates a specific team with an automation action in PagerDuty |
| `audit-escalation-policy-records` | `pagerduty.auditEscalationPolicyRecords()` | `--id` | 4 | Retrieves the audit records for a specific escalation policy in PagerDuty |
| `convert-service-rule-by-id` | `pagerduty.convertServiceRuleById()` | `--id` | 0 | Converts a service's Event Rules to Event Orchestration rules |
| `count-paused-incident-reports` | `pagerduty.countPausedIncidentReports()` | — | 4 | Retrieves the count of paused incident reports in the PagerDuty system |
| `create-and-manage-custom-incident-fields` | `pagerduty.createAndManageCustomIncidentFields()` | `--field--data--type` `--field--display--name` `--field--field--type` `--field--name` | 3 | Creates a new custom field for incidents in PagerDuty |
| `create-automation-runner-endpoint` | `pagerduty.createAutomationRunnerEndpoint()` | `--runner` | 0 | Creates a new Runbook Automation runner in PagerDuty's Automation Actions |
| `create-business-service` | `pagerduty.createBusinessService()` | — | 4 | This endpoint creates a new Business Service in PagerDuty, which represents a specific service or application that can be monitored and managed within the incident management platform |
| `create-custom-field-for-incident-type` | `pagerduty.createCustomFieldForIncidentType()` | `--field--data--type` `--field--display--name` `--field--field--type` `--field--name` `--type-id-or-name` | 4 | Create a Custom Field for an Incident Type |
| `create-escalation-policy` | `pagerduty.createEscalationPolicy()` | `--escalation-policy` | 0 | Creates a new escalation policy in PagerDuty, defining how incidents are escalated to different responders or teams |
| `create-event-orchestration` | `pagerduty.createEventOrchestration()` | `--orchestration--name` | 2 | Creates a new Event Orchestration in PagerDuty, which defines how incoming events are processed and routed to appropriate services |
| `create-event-rule-in-ruleset` | `pagerduty.createEventRuleInRuleset()` | `--id` | 1 | Creates a new Event Rule within a specified Ruleset in PagerDuty's incident management system |
| `create-extension-object` | `pagerduty.createExtensionObject()` | `--extension` | 0 | Creates a new extension in PagerDuty, allowing for additional functionality or integrations to be added to your services |
| `create-field-option-for-custom-field` | `pagerduty.createFieldOptionForCustomField()` | `--field--option--data--data--type` `--field--option--data--value` `--field-id` `--type-id-or-name` | 0 | Creates a new field option for a custom field on an incident type |
| `create-handoff-notification-rule` | `pagerduty.createHandoffNotificationRule()` | `--id` `--oncall--handoff--notification--rule--contact--method` `--oncall--handoff--notification--rule--handoff--type` | 2 | Creates a new on-call handoff notification rule for a specific user in PagerDuty |
| `create-incident-field-option` | `pagerduty.createIncidentFieldOption()` | `--field--option--data--data--type` `--field--option--data--value` `--field-id` | 0 | Creates a new field option for a specific custom field in PagerDuty's incident management system |
| `create-incident-record` | `pagerduty.createIncidentRecord()` | — | 18 | Creates a new incident in PagerDuty with specified details and assignments |
| `create-incident-type` | `pagerduty.createIncidentType()` | — | 5 | Create a new incident type |
| `create-incident-workflow` | `pagerduty.createIncidentWorkflow()` | `--incident-workflow` | 0 | This endpoint creates a new Incident Workflow in PagerDuty, allowing users to define a series of automated steps to be executed during incident response |
| `create-incident-workflow-instance` | `pagerduty.createIncidentWorkflowInstance()` | `--id` `--incident--workflow--instance--incident--id` | 1 | Creates a new instance of an incident workflow for a specific incident in PagerDuty |
| `create-integration-for-orchestration` | `pagerduty.createIntegrationForOrchestration()` | `--id` `--integration--label` | 0 | Creates a new integration for an existing event orchestration in PagerDuty |
| `create-integration-for-service` | `pagerduty.createIntegrationForService()` | `--id` `--integration` | 0 | Creates a new integration for a PagerDuty service to enable incident creation from external monitoring tools and systems |
| `create-maintenance-window-object` | `pagerduty.createMaintenanceWindowObject()` | `--maintenance-window` | 0 | Creates a new maintenance window in PagerDuty, allowing you to schedule periods of planned maintenance for specific services |
| `create-new-schedule-layer` | `pagerduty.createNewScheduleLayer()` | `--schedule` | 1 | Creates a new on-call schedule in PagerDuty with one or more rotation layers |
| `create-new-service` | `pagerduty.createNewService()` | `--service` | 0 | Creates a new service in PagerDuty, which is a key component for managing incidents and alerts |
| `create-new-tag-in-system` | `pagerduty.createNewTagInSystem()` | `--label` | 1 | Creates a new tag in PagerDuty for labeling and categorizing entities |
| `create-new-team-with-details` | `pagerduty.createNewTeamWithDetails()` | `--team` | 0 | Creates a new team in PagerDuty for organizing users, incident management, and on-call schedules |
| `create-new-webhook-subscription` ·common | `pagerduty.createNewWebhookSubscription()` | — | 13 | Creates a new webhook subscription in PagerDuty to receive specific event notifications |
| `create-or-update-status-page-post` | `pagerduty.createOrUpdateStatusPagePost()` | `--id` | 8 | Creates a new post on a PagerDuty Status Page to communicate service status to users |
| `create-or-update-status-page-postmortem` | `pagerduty.createOrUpdateStatusPagePostmortem()` | `--id` `--post-id` `--postmortem--message` `--postmortem--notify--subscribers` `--postmortem--post--id` | 2 | Creates or updates a postmortem for a specific status page post in PagerDuty |
| `create-response-play-for-incidents` | `pagerduty.createResponsePlayForIncidents()` | — | 0 | Creates a new Response Play in PagerDuty, which is a predefined set of actions to be executed in response to an incident |
| `create-ruleset` | `pagerduty.createRuleset()` | — | 0 | Creates a new Ruleset in PagerDuty for managing incident routing and notification rules |
| `create-schedule-overrides-configuration` | `pagerduty.createScheduleOverridesConfiguration()` | `--id` `--overrides` | 0 | Creates one or more overrides for a specific schedule in PagerDuty |
| `create-service-event-rule` | `pagerduty.createServiceEventRule()` | `--id` | 1 | Creates a new event rule for a specific service in PagerDuty |
| `create-status-page-subscription` | `pagerduty.createStatusPageSubscription()` | `--id` `--subscription--channel` `--subscription--contact` `--subscription--status--page--id` `--subscription--subscribable--object--id` `--subscription--subscribable--object--type` | 2 | Creates a new subscription for a PagerDuty status page |
| `create-status-update-template` | `pagerduty.createStatusUpdateTemplate()` | `--template--name` | 5 | Creates a new status update template in PagerDuty for standardized incident notifications |
| `create-trigger` | `pagerduty.createTrigger()` | `--trigger` | 0 | Creates a new incident workflow trigger in PagerDuty |
| `create-user-notification-rule` | `pagerduty.createUserNotificationRule()` | `--id` `--notification--rule--contact--method` `--notification--rule--start--delay--in--minutes` `--notification--rule--urgency` | 1 | Creates a new notification rule for a specific user in PagerDuty |
| `create-user-object` | `pagerduty.createUserObject()` | `--user` | 0 | Creates a new user in the PagerDuty system with the specified attributes |
| `create-user-status-update-notification-rule` | `pagerduty.createUserStatusUpdateNotificationRule()` | `--id` `--status--update--notification--rule--contact--method` | 0 | Creates a new status update notification rule for a specific user in PagerDuty |
| `create-workflow-integration-connection` | `pagerduty.createWorkflowIntegrationConnection()` | `--integration-id` `--name` | 11 | Create a new Workflow Integration Connection |
| `delete-account-subscription-by-id` | `pagerduty.deleteAccountSubscriptionById()` | `--id` | 0 | Deletes the account subscription associated with a specific business service in PagerDuty |
| `delete-addon-by-id` | `pagerduty.deleteAddonById()` | `--id` | 0 | Deletes a specific add-on from the PagerDuty account using its unique identifier |
| `delete-alert-grouping-setting` | `pagerduty.deleteAlertGroupingSetting()` | `--id` | 0 | This endpoint allows you to delete specific alert grouping settings in PagerDuty |
| `delete-all-oauth-delegations` | `pagerduty.deleteAllOauthDelegations()` | `--type` `--user-id` | 0 | Delete all OAuth delegations for a user based on the specified type |
| `delete-automation-action-by-id` | `pagerduty.deleteAutomationActionById()` | `--id` | 0 | Deletes a specific Automation Action from the PagerDuty system |
| `delete-automation-action-service-by-id` | `pagerduty.deleteAutomationActionServiceById()` | `--id` `--service-id` | 0 | This endpoint removes a specific automation action from a particular service in PagerDuty |
| `delete-automation-actions-runner-by-id` | `pagerduty.deleteAutomationActionsRunnerById()` | `--id` | 0 | Permanently deletes an automation actions runner from PagerDuty |
| `delete-business-service-by-id` | `pagerduty.deleteBusinessServiceById()` | `--id` | 0 | Deletes a specific business service from the PagerDuty system |
| `delete-business-service-priority-thresholds` | `pagerduty.deleteBusinessServicePriorityThresholds()` | — | 0 | Deletes the account-level global priority threshold for business services in PagerDuty |
| `delete-cache-variable-for-event` | `pagerduty.deleteCacheVariableForEvent()` | `--cache-variable-id` `--id` | 0 | Deletes a specific cache variable associated with an event orchestration in PagerDuty |
| `delete-cache-variable-from-service` | `pagerduty.deleteCacheVariableFromService()` | `--cache-variable-id` `--service-id` | 0 | Deletes a cache variable from a service's event orchestration |
| `delete-custom-field-by-field-id` | `pagerduty.deleteCustomFieldByFieldId()` | `--field-id` | 0 | Deletes a specific custom field from incidents in PagerDuty |
| `delete-custom-field-for-incident-type` | `pagerduty.deleteCustomFieldForIncidentType()` | `--field-id` `--type-id-or-name` | 0 | Deletes a custom field from an incident type |
| `delete-escalation-policy-by-id` | `pagerduty.deleteEscalationPolicyById()` | `--id` | 0 | Permanently removes a specific escalation policy from the PagerDuty system |
| `delete-event-by-id` | `pagerduty.deleteEventById()` | `--id` | 0 | Deletes a specific Event Orchestration from the PagerDuty system |
| `delete-extension-by-id` | `pagerduty.deleteExtensionById()` | `--id` | 0 | Deletes a specific extension from the PagerDuty service |
| `delete-field-option` | `pagerduty.deleteFieldOption()` | `--field-id` `--field-option-id` | 0 | Permanently deletes a field option from a custom incident field |
| `delete-field-option-for-custom-field` | `pagerduty.deleteFieldOptionForCustomField()` | `--field-id` `--field-option-id` `--type-id-or-name` | 0 | Deletes a specific field option from a custom field on an incident type |
| `delete-incident-workflow-by-id` | `pagerduty.deleteIncidentWorkflowById()` | `--id` | 0 | Deletes a specific incident workflow from the PagerDuty system |
| `delete-incident-workflow-trigger-by-id` | `pagerduty.deleteIncidentWorkflowTriggerById()` | `--id` | 0 | Deletes a specific trigger associated with an incident workflow in PagerDuty |
| `delete-incident-workflow-trigger-service` | `pagerduty.deleteIncidentWorkflowTriggerService()` | `--service-id` `--trigger-id` | 0 | Removes a service from an incident workflow trigger in PagerDuty |
| `delete-integration-from-event-orchestration` | `pagerduty.deleteIntegrationFromEventOrchestration()` | `--id` `--integration-id` | 0 | Removes a specific integration from an event orchestration in PagerDuty |
| `delete-maintenance-window-by-id` | `pagerduty.deleteMaintenanceWindowById()` | `--id` | 0 | Deletes a specific maintenance window in PagerDuty's incident management system |
| `delete-oncall-handoff-notification-rule` | `pagerduty.deleteOncallHandoffNotificationRule()` | `--id` `--oncall-handoff-notification-rule-id` | 0 | This endpoint deletes a specific on-call handoff notification rule for a given user in PagerDuty |
| `delete-post-from-status-page` | `pagerduty.deletePostFromStatusPage()` | `--id` `--post-id` | 0 | This endpoint deletes a specific post from a PagerDuty status page |
| `delete-post-update-by-id` | `pagerduty.deletePostUpdateById()` | `--id` `--post-id` `--post-update-id` | 0 | This endpoint deletes a specific post update from a status page post in PagerDuty |
| `delete-response-play` | `pagerduty.deleteResponsePlay()` | `--id` | 0 | Deletes a specific Response Play from the PagerDuty system |
| `delete-rule-from-ruleset-by-id` | `pagerduty.deleteRuleFromRulesetById()` | `--id` `--rule-id` | 0 | Deletes a specific event rule from a ruleset in PagerDuty |
| `delete-ruleset-by-id` | `pagerduty.deleteRulesetById()` | `--id` | 0 | Deletes a specific ruleset from the PagerDuty system based on the provided ID |
| `delete-runner-team-association` | `pagerduty.deleteRunnerTeamAssociation()` | `--id` `--team-id` | 0 | This endpoint removes a team's association from a specific Automation Action runner in PagerDuty |
| `delete-schedule-by-id` | `pagerduty.deleteScheduleById()` | `--id` | 0 | The DeleteSchedule endpoint removes a specific schedule from the PagerDuty system |
| `delete-schedule-override-by-id` | `pagerduty.deleteScheduleOverrideById()` | `--id` `--override-id` | 0 | This endpoint deletes a specific override from a PagerDuty schedule |
| `delete-service-by-id` | `pagerduty.deleteServiceById()` | `--id` | 0 | Deletes a specific service from the PagerDuty account |
| `delete-service-rule-by-id` | `pagerduty.deleteServiceRuleById()` | `--id` `--rule-id` | 0 | Deletes a specific rule from a PagerDuty service |
| `delete-status-page-postmortem` | `pagerduty.deleteStatusPagePostmortem()` | `--id` `--post-id` | 0 | This endpoint allows you to delete a postmortem associated with a specific post on a PagerDuty status page |
| `delete-status-update-notification-rule` | `pagerduty.deleteStatusUpdateNotificationRule()` | `--id` `--status-update-notification-rule-id` | 0 | Deletes a specific status update notification rule associated with a user in the PagerDuty system |
| `delete-subscription-from-status-page` | `pagerduty.deleteSubscriptionFromStatusPage()` | `--id` `--subscription-id` | 0 | Deletes a specific subscription associated with a PagerDuty status page |
| `delete-tag-by-id` | `pagerduty.deleteTagById()` | `--id` | 0 | Deletes a specific tag from the PagerDuty system based on its unique identifier |
| `delete-team-by-id` | `pagerduty.deleteTeamById()` | `--id` | 1 | Deletes a team from PagerDuty by its ID |
| `delete-team-escalation-policy` | `pagerduty.deleteTeamEscalationPolicy()` | `--escalation-policy-id` `--id` | 0 | This endpoint removes an escalation policy association from a specific team in PagerDuty |
| `delete-team-from-automation-action` | `pagerduty.deleteTeamFromAutomationAction()` | `--id` `--team-id` | 0 | This endpoint removes a specific team's access to an Automation Action in PagerDuty |
| `delete-template-by-id` | `pagerduty.deleteTemplateById()` | `--id` | 0 | Deletes a specific template from the PagerDuty account |
| `delete-user-by-id` | `pagerduty.deleteUserById()` | `--id` | 0 | Deletes a specific user from the PagerDuty system using their unique identifier |
| `delete-user-contact-method` | `pagerduty.deleteUserContactMethod()` | `--contact-method-id` `--id` | 0 | Deletes a specific contact method associated with a user in PagerDuty |
| `delete-user-from-team-by-id` | `pagerduty.deleteUserFromTeamById()` | `--id` `--user-id` | 0 | This endpoint removes a specific user from a designated team within the PagerDuty incident management platform |
| `delete-user-notification-rule` | `pagerduty.deleteUserNotificationRule()` | `--id` `--notification-rule-id` | 0 | Deletes a specific notification rule for a user in PagerDuty |
| `delete-user-session-by-id` | `pagerduty.deleteUserSessionById()` | `--id` | 0 | Deletes all active sessions for a specified user in the PagerDuty system |
| `delete-user-session-by-type` | `pagerduty.deleteUserSessionByType()` | `--id` `--session-id` `--type` | 0 | This endpoint deletes a specific user session in PagerDuty |
| `delete-webhook-subscription-by-id` | `pagerduty.deleteWebhookSubscriptionById()` | `--id` | 0 | Deletes a specific webhook subscription from your PagerDuty account |
| `delete-workflow-integration-connection` | `pagerduty.deleteWorkflowIntegrationConnection()` | `--id` `--integration-id` | 0 | Deletes a specific workflow integration connection from PagerDuty |
| `disassociate-service-dependencies` | `pagerduty.disassociateServiceDependencies()` | — | 1 | Disassociates (removes) service dependencies in PagerDuty by deleting specified relationships between supporting and dependent services |
| `edit-webhook-subscription-by-id` | `pagerduty.editWebhookSubscriptionById()` | `--id` | 5 | Edit an existing webhook subscription in PagerDuty to modify its configuration |
| `enable-extension-by-id` | `pagerduty.enableExtensionById()` | `--id` | 0 | Enables a temporarily disabled extension in PagerDuty |
| `enable-webhook-subscription-by-id` | `pagerduty.enableWebhookSubscriptionById()` | `--id` | 0 | Activates a specific webhook subscription in PagerDuty, enabling the system to send notifications for the events configured in that subscription |
| `execute-response-play-by-id` | `pagerduty.executeResponsePlayById()` | `--From` `--incident--id` `--response-play-id` | 1 | Executes a predefined Response Play for a specific incident in PagerDuty |
| `fetch-cache-variable-for-event-orchestration` | `pagerduty.fetchCacheVariableForEventOrchestration()` | `--cache-variable-id` `--id` | 0 | Retrieves detailed information about a specific cache variable in a PagerDuty event orchestration |
| `fetch-custom-incident-field-by-id` | `pagerduty.fetchCustomIncidentFieldById()` | `--field-id` | 1 | Retrieves detailed information about a specific custom field associated with incidents in PagerDuty |
| `fetch-escalation-polices-list` ·common | `pagerduty.fetchEscalationPolicesList()` | — | 8 | Retrieves a list of escalation policies configured in the PagerDuty account |
| `fetch-event-orchestrations` | `pagerduty.fetchEventOrchestrations()` | — | 3 | Retrieves a list of event orchestrations configured in the PagerDuty account |
| `fetch-incident-analytics-by-id` | `pagerduty.fetchIncidentAnalyticsById()` | `--id` | 0 | Retrieves raw analytics data for a specific incident in PagerDuty |
| `fetch-incident-list` ·common | `pagerduty.fetchIncidentList()` | — | 15 | Retrieves a list of incidents from PagerDuty based on specified criteria |
| `fetch-outlier-incident-by-id` | `pagerduty.fetchOutlierIncidentById()` | `--id` | 2 | Retrieves detailed information about an outlier incident associated with a specific incident in PagerDuty |
| `fetch-post-update-status` | `pagerduty.fetchPostUpdateStatus()` | `--id` `--post-id` `--post-update-id` | 0 | Retrieves detailed information about a specific post update on a PagerDuty status page |
| `fetch-priorities-list` | `pagerduty.fetchPrioritiesList()` | — | 3 | Retrieves a list of existing priorities in the PagerDuty system, ordered from most severe to least severe |
| `fetch-related-change-events-for-incident` | `pagerduty.fetchRelatedChangeEventsForIncident()` | `--id` | 1 | Retrieves change events correlated with a specific incident, along with the reasons for correlation |
| `fetch-related-incidents-by-id` | `pagerduty.fetchRelatedIncidentsById()` | `--id` | 1 | Retrieves a list of incidents that are potentially related to a specified incident in PagerDuty |
| `fetch-runner-teams-integration` | `pagerduty.fetchRunnerTeamsIntegration()` | `--id` | 0 | Retrieves a list of teams associated with a specific Automation Action Runner in PagerDuty |
| `fetch-status-pages` | `pagerduty.fetchStatusPages()` | — | 1 | Retrieves a list of all status pages configured in the PagerDuty account |
| `fetch-user-contact-method` | `pagerduty.fetchUserContactMethod()` | `--contact-method-id` `--id` | 0 | Retrieves detailed information about a specific contact method for a particular user in PagerDuty |
| `fetch-vendor-list` | `pagerduty.fetchVendorList()` | — | 3 | Retrieves a list of vendors or third-party integrations available in the PagerDuty platform |
| `filter-and-aggregate-incident-metrics` | `pagerduty.filterAndAggregateIncidentMetrics()` | — | 17 | Analyzes and aggregates incident metrics across teams in PagerDuty, allowing for detailed filtering and customization of results |
| `get-addons-list` | `pagerduty.getAddonsList()` | — | 6 | Retrieves a list of all addons associated with the PagerDuty account |
| `get-aggregated-pd-advance-usage-data` | `pagerduty.getAggregatedPdAdvanceUsageData()` | — | 15 | Provides aggregated metrics for the usage of PD Advance. <!-- theme: info --> > Note: Analytics data is updated… |
| `get-alert-grouping-settings` | `pagerduty.getAlertGroupingSettings()` | — | 5 | Lists all alert grouping settings configured in your PagerDuty account |
| `get-alerts-by-incident-id` ·common | `pagerduty.getAlertsByIncidentId()` | `--id` | 7 | Retrieves all alerts associated with a specific incident in PagerDuty |
| `get-analytics-metrics-incidents-all` | `pagerduty.getAnalyticsMetricsIncidentsAll()` | — | 5 | Retrieves aggregated incident analytics data for all incidents in PagerDuty |
| `get-analytics-metrics-users-all` | `pagerduty.getAnalyticsMetricsUsersAll()` | — | 2 | Get aggregated metrics for all users across the account |
| `get-analytics-raw-incidents-responses` | `pagerduty.getAnalyticsRawIncidentsResponses()` | `--id` | 4 | Retrieves raw response data from a single incident in PagerDuty |
| `get-analytics-raw-users` | `pagerduty.getAnalyticsRawUsers()` | — | 12 | Get raw user analytics data from PagerDuty |
| `get-audit-records` | `pagerduty.getAuditRecords()` | — | 10 | Retrieves a list of audit records from the PagerDuty system |
| `get-automation-action-by-id` | `pagerduty.getAutomationActionById()` | `--id` | 0 | Retrieves detailed information about a specific automation action in PagerDuty's incident management platform |
| `get-automation-action-runner-by-id` | `pagerduty.getAutomationActionRunnerById()` | `--id` | 0 | Retrieves detailed information about a specific Automation Action Runner in PagerDuty |
| `get-automation-action-team-by-team-id` | `pagerduty.getAutomationActionTeamByTeamId()` | `--id` `--team-id` | 0 | Retrieves detailed information about a specific team's association with an automation action in PagerDuty |
| `get-automation-actions-runners` | `pagerduty.getAutomationActionsRunners()` | — | 4 | Lists all automation action runners in your PagerDuty account |
| `get-business-service-subscribers-by-id` | `pagerduty.getBusinessServiceSubscribersById()` | `--id` | 0 | Retrieves a list of subscribers for a specific business service in PagerDuty |
| `get-business-services-impacts` | `pagerduty.getBusinessServicesImpacts()` | — | 2 | List Business Services sorted by impacted status |
| `get-business-services-priority-thresholds` | `pagerduty.getBusinessServicesPriorityThresholds()` | — | 0 | Retrieves the current priority threshold settings for all business services in PagerDuty |
| `get-cache-variable-by-id` | `pagerduty.getCacheVariableById()` | `--cache-variable-id` `--service-id` | 0 | Retrieves detailed information about a specific cache variable associated with a particular service within an event orchestration in PagerDuty |
| `get-cache-variables-for-service` | `pagerduty.getCacheVariablesForService()` | `--service-id` | 0 | Lists all cache variables configured for a Service Event Orchestration |
| `get-escalation-policy-by-id` | `pagerduty.getEscalationPolicyById()` | `--id` | 1 | Retrieves detailed information about a specific escalation policy in PagerDuty |
| `get-event-integrations-by-id` | `pagerduty.getEventIntegrationsById()` | `--id` | 0 | Retrieves a list of integrations associated with a specific event orchestration in PagerDuty |
| `get-event-orchestration-by-id` | `pagerduty.getEventOrchestrationById()` | `--id` | 0 | Retrieves detailed information about a specific event orchestration in PagerDuty using its unique identifier |
| `get-event-orchestration-cache-variables` | `pagerduty.getEventOrchestrationCacheVariables()` | `--id` | 0 | Lists all cache variables configured for a specific Global Event Orchestration |
| `get-event-orchestration-global` | `pagerduty.getEventOrchestrationGlobal()` | `--id` | 0 | Get the Global Orchestration configuration for an Event Orchestration |
| `get-event-orchestration-integration` | `pagerduty.getEventOrchestrationIntegration()` | `--id` `--integration-id` | 0 | Retrieves detailed information about a specific integration associated with an event orchestration in PagerDuty |
| `get-extension-schema-by-id` | `pagerduty.getExtensionSchemaById()` | `--id` | 0 | Retrieves a specific extension schema from PagerDuty by its unique identifier |
| `get-field-option-on-custom-field` | `pagerduty.getFieldOptionOnCustomField()` | `--field-id` `--field-option-id` `--type-id-or-name` | 0 | Retrieves a specific field option from a custom field on an incident type |
| `get-impact-by-status-page-id` | `pagerduty.getImpactByStatusPageId()` | `--id` `--impact-id` | 0 | Retrieves detailed information about a specific impact level configuration on a PagerDuty status page |
| `get-incident-alert-details` | `pagerduty.getIncidentAlertDetails()` | `--alert-id` `--id` | 0 | Retrieves detailed information about a specific alert associated with a particular incident in PagerDuty |
| `get-incident-log-entries-by-id` | `pagerduty.getIncidentLogEntriesById()` | `--id` | 8 | Retrieves all log entries associated with a specific incident in PagerDuty |
| `get-incident-type` | `pagerduty.getIncidentType()` | `--type-id-or-name` | 0 | Get detailed information about a single incident type |
| `get-incident-type-custom-field` | `pagerduty.getIncidentTypeCustomField()` | `--field-id` `--type-id-or-name` | 1 | Get a custom field for an incident type |
| `get-incident-workflow-action-by-id` | `pagerduty.getIncidentWorkflowActionById()` | `--id` | 0 | Retrieves detailed information about a specific incident workflow action by its ID |
| `get-incident-workflows` | `pagerduty.getIncidentWorkflows()` | — | 5 | Lists all incident workflows configured in your PagerDuty account |
| `get-incident-workflows-actions` | `pagerduty.getIncidentWorkflowsActions()` | — | 3 | Retrieves a list of all available actions that can be used in incident workflows within PagerDuty |
| `get-jira-cloud-account-mappings` | `pagerduty.getJiraCloudAccountMappings()` | — | 3 | Lists all account mappings between PagerDuty and Jira Cloud instances |
| `get-log-entries` | `pagerduty.getLogEntries()` | — | 9 | Retrieves log entries from the PagerDuty system, providing a detailed history of events and actions related to incidents and system activities |
| `get-maintenance-window-by-id` | `pagerduty.getMaintenanceWindowById()` | `--id` | 1 | Retrieves detailed information about a specific maintenance window in PagerDuty |
| `get-oauth-delegations-revocation-requests-status` | `pagerduty.getOauthDelegationsRevocationRequestsStatus()` | — | 1 | This endpoint is deprecated |
| `get-paused-incident-alerts` | `pagerduty.getPausedIncidentAlerts()` | — | 4 | Retrieves the most recent paused incident alerts from PagerDuty for a specified reporting period |
| `get-post-from-status-page-by-id` | `pagerduty.getPostFromStatusPageById()` | `--id` `--post-id` | 1 | Retrieves detailed information about a specific post on a PagerDuty status page |
| `get-response-plays` | `pagerduty.getResponsePlays()` | — | 2 | This endpoint was deprecated and removed in June 2024 |
| `get-rule-from-ruleset-by-id` | `pagerduty.getRuleFromRulesetById()` | `--id` `--rule-id` | 0 | Retrieves detailed information about a specific rule within a PagerDuty ruleset |
| `get-schedules` | `pagerduty.getSchedules()` | — | 6 | Retrieves a list of all schedules from your PagerDuty account |
| `get-scim-resource-types` | `pagerduty.getScimResourceTypes()` | — | 0 | Get SCIM resource types supported by PagerDuty's SCIM service provider |
| `get-scim-schema-by-id` | `pagerduty.getScimSchemaById()` | `--id` | 0 | Retrieves an individual SCIM schema definition by its unique identifier (ID) |
| `get-scim-service-provider-config` | `pagerduty.getScimServiceProviderConfig()` | — | 0 | Retrieves the SCIM 2.0 Service Provider Configuration for PagerDuty |
| `get-scim-user` | `pagerduty.getScimUser()` | `--id` | 0 | Retrieves detailed information about a specific user from PagerDuty's SCIM directory |
| `get-service-custom-field-values` | `pagerduty.getServiceCustomFieldValues()` | `--id` | 0 | Retrieves the custom field values for a specific PagerDuty service |
| `get-service-enablements` | `pagerduty.getServiceEnablements()` | `--id` | 0 | Retrieves feature enablement settings for a specific PagerDuty service |
| `get-service-impacts-by-url-slug` | `pagerduty.getServiceImpactsByUrlSlug()` | `--url-slug` | 1 | Retrieves service impacts for a specific status dashboard in PagerDuty |
| `get-service-orchestration-for-service` | `pagerduty.getServiceOrchestrationForService()` | `--service-id` | 1 | Get a Service Orchestration |
| `get-severity-for-status-page` | `pagerduty.getSeverityForStatusPage()` | `--id` `--severity-id` | 0 | Retrieves detailed information about a specific severity level on a particular status page in PagerDuty |
| `get-specific-post-update-status` | `pagerduty.getSpecificPostUpdateStatus()` | `--id` `--post-id` | 1 | Retrieves the updates for a specific post on a PagerDuty status page |
| `get-status-dashboard-by-id` | `pagerduty.getStatusDashboardById()` | `--id` | 0 | Retrieves detailed information about a specific status dashboard in PagerDuty |
| `get-status-for-status-page-by-id` | `pagerduty.getStatusForStatusPageById()` | `--id` `--status-id` | 0 | Retrieves the current status of a specific item on a PagerDuty status page |
| `get-status-page-impacts-by-id` | `pagerduty.getStatusPageImpactsById()` | `--id` | 1 | Retrieves the list of impact level configurations available for a specific status page in PagerDuty |
| `get-status-page-subscription` | `pagerduty.getStatusPageSubscription()` | `--id` `--subscription-id` | 0 | Retrieves detailed information about a specific subscription associated with a particular status page in PagerDuty |
| `get-tags-by-entity-type` | `pagerduty.getTagsByEntityType()` | `--entity-type` `--id` | 3 | Retrieves all entities of a specific type that are associated with a given tag |
| `get-team-members-by-id` | `pagerduty.getTeamMembersById()` | `--id` | 4 | Retrieves a list of all members associated with a specific team in PagerDuty |
| `get-team-notification-subscriptions` | `pagerduty.getTeamNotificationSubscriptions()` | `--id` | 0 | Retrieves the notification subscriptions for a specific team in PagerDuty |
| `get-teams-associated-with-action-id` | `pagerduty.getTeamsAssociatedWithActionId()` | `--id` | 0 | Retrieves the list of teams associated with a specific automation action in PagerDuty |
| `get-template-by-id` | `pagerduty.getTemplateById()` | `--id` | 0 | Retrieves detailed information about a specific template in PagerDuty by its unique identifier |
| `get-trigger` | `pagerduty.getTrigger()` | `--id` | 0 | Retrieves details of a specific incident workflow trigger by ID |
| `get-user-notification-subscriptions` | `pagerduty.getUserNotificationSubscriptions()` | `--id` | 0 | Lists notification subscriptions for a specific PagerDuty user |
| `get-user-session-by-type` | `pagerduty.getUserSessionByType()` | `--id` `--session-id` `--type` | 0 | Retrieves detailed information about a specific user session in PagerDuty |
| `get-user-sessions-by-id` | `pagerduty.getUserSessionsById()` | `--id` | 0 | Retrieves all active sessions for a specific user in PagerDuty |
| `get-user-status-update-notification-rules` | `pagerduty.getUserStatusUpdateNotificationRules()` | `--id` | 1 | Retrieves all status update notification rules for a specific user in PagerDuty |
| `get-webhook-subscription-by-id` | `pagerduty.getWebhookSubscriptionById()` | `--id` | 0 | Retrieves detailed information about a specific webhook subscription in PagerDuty |
| `get-workflow-integration` | `pagerduty.getWorkflowIntegration()` | `--id` | 0 | Get details about a Workflow Integration |
| `get-workflow-integration-connection` | `pagerduty.getWorkflowIntegrationConnection()` | `--id` `--integration-id` | 0 | Get details about a Workflow Integration Connection |
| `install-add-on-endpoint` | `pagerduty.installAddOnEndpoint()` | `--addon` | 0 | This endpoint allows you to install a new add-on to your PagerDuty account, enhancing its functionality with custom integrations |
| `invoke-automation-action-by-id` | `pagerduty.invokeAutomationActionById()` | `--id` `--invocation--metadata--incident--id` | 0 | Invokes a specific automation action in PagerDuty, associating it with a particular incident |
| `list-all-workflow-integration-connections` | `pagerduty.listAllWorkflowIntegrationConnections()` | — | 3 | List all Workflow Integration Connections |
| `list-automation-action-details` | `pagerduty.listAutomationActionDetails()` | — | 8 | This endpoint retrieves a list of automation actions configured in the PagerDuty account |
| `list-extension-schemas` | `pagerduty.listExtensionSchemas()` | — | 3 | Retrieves all available extension schemas from the PagerDuty API |
| `list-field-options-on-custom-field` | `pagerduty.listFieldOptionsOnCustomField()` | `--field-id` `--type-id-or-name` | 0 | Lists all field options for a custom field on an incident type |
| `list-incident-status-update-subscribers` | `pagerduty.listIncidentStatusUpdateSubscribers()` | `--id` | 0 | Retrieves a list of subscribers to status updates for a specific incident in PagerDuty |
| `list-incident-type-custom-fields` | `pagerduty.listIncidentTypeCustomFields()` | `--type-id-or-name` | 1 | List the custom fields for an incident type |
| `list-incident-types` | `pagerduty.listIncidentTypes()` | — | 1 | List the available incident types Incident Types are a feature which will allow customers to categorize incidents, such as a security incident, a major incident, or a fraud incident |
| `list-licenses` | `pagerduty.listLicenses()` | — | 0 | Lists all licenses for the PagerDuty account, showing current usage and available allocations |
| `list-scim-schemas` | `pagerduty.listScimSchemas()` | — | 0 | Retrieves all SCIM schemas supported by the PagerDuty service provider |
| `list-scim-users` | `pagerduty.listScimUsers()` | — | 3 | Lists users via the SCIM (System for Cross-domain Identity Management) API endpoint |
| `list-service-custom-fields` | `pagerduty.listServiceCustomFields()` | — | 1 | Lists all custom fields available for services in PagerDuty |
| `list-supporting-service-impacts` | `pagerduty.listSupportingServiceImpacts()` | `--id` | 2 | Retrieves information about the impacts of supporting services on a specific business service in PagerDuty |
| `list-templates` | `pagerduty.listTemplates()` | — | 6 | Retrieves a list of templates available in the PagerDuty system |
| `list-workflow-integration-connections` | `pagerduty.listWorkflowIntegrationConnections()` | `--integration-id` | 3 | List all workflow integration connections for a specific workflow integration |
| `list-workflow-integrations` | `pagerduty.listWorkflowIntegrations()` | — | 3 | List available Workflow Integrations |
| `manage-cache-variables-for-event-service` | `pagerduty.manageCacheVariablesForEventService()` | `--cache--variable--configuration` `--cache--variable--name` `--service-id` | 11 | Creates a cache variable for a service event orchestration |
| `merge-source-incidents-into-target-incident` | `pagerduty.mergeSourceIncidentsIntoTargetIncident()` | `--id` `--source-incidents` | 0 | Merges multiple source incidents into a target incident in PagerDuty's incident management system |
| `migrate-integration-between-orchestrations` | `pagerduty.migrateIntegrationBetweenOrchestrations()` | `--id` `--integration-id` `--source-id` `--source-type` | 0 | This endpoint facilitates the migration of an integration from one event orchestration to another within PagerDuty |
| `modify-entity-tags` | `pagerduty.modifyEntityTags()` | `--entity-type` `--id` | 2 | Add and/or remove tags from a PagerDuty entity (user, team, or escalation policy) in a single operation |
| `ping-webhook-subscription` | `pagerduty.pingWebhookSubscription()` | `--id` | 0 | The PingWebhookSubscription endpoint sends a test POST request to a specified webhook subscription in your PagerDuty account |
| `post-account-subscription-for-business-service` | `pagerduty.postAccountSubscriptionForBusinessService()` | `--id` | 0 | This endpoint creates or updates an account subscription for a specific business service in PagerDuty |
| `post-alert-grouping-settings` | `pagerduty.postAlertGroupingSettings()` | — | 8 | Creates a new Alert Grouping Setting in PagerDuty, defining how alerts will be automatically grouped into incidents based on specified configurations |
| `post-analytic-metrics-on-escalation-policies` | `pagerduty.postAnalyticMetricsOnEscalationPolicies()` | — | 17 | Retrieves and aggregates analytics metrics for incidents related to escalation policies in PagerDuty |
| `post-analytics-metrics-responder-filters` | `pagerduty.postAnalyticsMetricsResponderFilters()` | — | 10 | The AnalyzeResponderMetrics endpoint aggregates and analyzes responder performance metrics for PagerDuty incidents |
| `post-change-events` | `pagerduty.postChangeEvents()` | `--payload` `--routing-key` | 1 | Send a change event to PagerDuty to track deployments, configuration changes, or other significant system modifications |
| `post-event-orchestration-cache-variables` | `pagerduty.postEventOrchestrationCacheVariables()` | `--cache--variable--configuration` `--cache--variable--name` `--id` | 2 | Creates a new cache variable within a PagerDuty event orchestration |
| `post-incident-metrics` | `pagerduty.postIncidentMetrics()` | — | 10 | Retrieve analytics metrics for responders and teams including incident counts, response times, on-call hours, interruptions, escalations, and engagement statistics |
| `post-incident-metrics-with-filters` | `pagerduty.postIncidentMetricsWithFilters()` | — | 17 | This endpoint retrieves and aggregates analytics metrics for incidents across all teams in PagerDuty |
| `post-incident-note-using-id` | `pagerduty.postIncidentNoteUsingId()` | `--id` `--note--content` | 0 | Adds a new note to an existing incident in PagerDuty |
| `post-incident-status-update` | `pagerduty.postIncidentStatusUpdate()` | `--id` `--message` | 2 | Posts a status update for a specific incident in PagerDuty |
| `post-incidents-analytics-with-filters` | `pagerduty.postIncidentsAnalyticsWithFilters()` | — | 15 | The AnalyzeRawIncidents endpoint retrieves and analyzes raw incident data from PagerDuty |
| `post-incidents-metrics-filtered-by-service` | `pagerduty.postIncidentsMetricsFilteredByService()` | — | 17 | The AnalyzeIncidentMetrics endpoint aggregates and analyzes incident data for PagerDuty services based on specified filters and parameters |
| `post-responder-incidents-with-filters` | `pagerduty.postResponderIncidentsWithFilters()` | `--responder-id` | 14 | Retrieves a list of incidents associated with a specific responder in the PagerDuty incident management system |
| `post-service-automation-action` | `pagerduty.postServiceAutomationAction()` | `--id` `--service` | 0 | This endpoint adds a service to an existing automation action in PagerDuty |
| `post-team-notification-subscription` | `pagerduty.postTeamNotificationSubscription()` | `--id` `--subscribables` | 0 | Creates notification subscriptions for a specific team in PagerDuty |
| `post-team-to-runner` | `pagerduty.postTeamToRunner()` | `--id` `--team` | 0 | This endpoint adds a team to an Automation Action Runner in PagerDuty |
| `preview-schedule-object` | `pagerduty.previewScheduleObject()` | `--schedule` | 3 | The preview_schedule endpoint allows you to simulate and visualize a PagerDuty schedule configuration before actually creating or updating it |
| `render-template-for-incident` | `pagerduty.renderTemplateForIncident()` | `--id` `--incident-id` | 2 | Renders a specific template for a given incident in PagerDuty |
| `retrieve-abilities-list` | `pagerduty.retrieveAbilitiesList()` | — | 0 | Retrieves a list of abilities or capabilities available in the PagerDuty system |
| `retrieve-ability-by-id` | `pagerduty.retrieveAbilityById()` | `--id` | 0 | Tests whether a specific ability (feature capability) is available to your PagerDuty account using its unique identifier |
| `retrieve-action-services-by-id` | `pagerduty.retrieveActionServicesById()` | `--id` | 0 | Retrieves a list of services associated with a specific automation action in PagerDuty |
| `retrieve-active-service-event-by-id` | `pagerduty.retrieveActiveServiceEventById()` | `--service-id` | 0 | Check if event orchestration is active for a specific PagerDuty service |
| `retrieve-addon-by-id` | `pagerduty.retrieveAddonById()` | `--id` | 0 | Retrieves detailed information about a specific addon installed on a PagerDuty account |
| `retrieve-alert-grouping-settings-by-id` | `pagerduty.retrieveAlertGroupingSettingsById()` | `--id` | 0 | Retrieves the alert grouping settings for a specific configuration identified by its unique ID in PagerDuty |
| `retrieve-automation-action-invocation-by-id` | `pagerduty.retrieveAutomationActionInvocationById()` | `--id` | 0 | Retrieves detailed information about a specific automation action invocation in PagerDuty |
| `retrieve-automation-action-invocations` | `pagerduty.retrieveAutomationActionInvocations()` | — | 4 | Retrieves a list of automation action invocations from the PagerDuty incident management platform |
| `retrieve-automation-action-runner-teams` | `pagerduty.retrieveAutomationActionRunnerTeams()` | `--id` `--team-id` | 0 | Retrieves detailed information about a specific team association with an Automation Actions runner in PagerDuty |
| `retrieve-automation-service-action` | `pagerduty.retrieveAutomationServiceAction()` | `--id` `--service-id` | 0 | Retrieves detailed information about the association between a specific automation action and a service in PagerDuty |
| `retrieve-business-service-by-id` | `pagerduty.retrieveBusinessServiceById()` | `--id` | 0 | Retrieves detailed information about a specific business service by its ID |
| `retrieve-business-service-dependencies` | `pagerduty.retrieveBusinessServiceDependencies()` | `--id` | 0 | Retrieves the service dependencies for a specific business service in PagerDuty |
| `retrieve-business-service-impactors` | `pagerduty.retrieveBusinessServiceImpactors()` | — | 1 | Retrieves impactors (typically incidents) currently affecting business services |
| `retrieve-business-service-impacts` | `pagerduty.retrieveBusinessServiceImpacts()` | `--id` | 0 | Retrieves a list of business services impacted by a specific PagerDuty incident |
| `retrieve-business-services` | `pagerduty.retrieveBusinessServices()` | — | 3 | Retrieve a list of business services from your PagerDuty account |
| `retrieve-change-event-by-id` | `pagerduty.retrieveChangeEventById()` | `--id` | 0 | Retrieves detailed information about a specific change event by its unique ID |
| `retrieve-change-event-information` | `pagerduty.retrieveChangeEventInformation()` | — | 7 | Retrieves change events from PagerDuty |
| `retrieve-current-user-info` | `pagerduty.retrieveCurrentUserInfo()` | — | 1 | Retrieves the profile information of the currently authenticated user in the PagerDuty system |
| `retrieve-entity-tags-by-id` | `pagerduty.retrieveEntityTagsById()` | `--entity-type` `--id` | 3 | Retrieves the tags associated with a specific entity in the PagerDuty system |
| `retrieve-event-orchestration-router-by-id` | `pagerduty.retrieveEventOrchestrationRouterById()` | `--id` | 0 | Retrieves the router configuration for a specific event orchestration in PagerDuty |
| `retrieve-extension-by-id` | `pagerduty.retrieveExtensionById()` | `--id` | 1 | Retrieves detailed information about a specific extension in PagerDuty |
| `retrieve-extension-list` | `pagerduty.retrieveExtensionList()` | — | 7 | Retrieves a paginated list of extensions associated with the authenticated PagerDuty account |
| `retrieve-incident-by-incident-id` | `pagerduty.retrieveIncidentByIncidentId()` | `--id` | 1 | Retrieves detailed information about a specific incident in PagerDuty using its unique identifier |
| `retrieve-incident-custom-field-values` | `pagerduty.retrieveIncidentCustomFieldValues()` | `--id` | 0 | Retrieves the custom field values associated with a specific incident in PagerDuty |
| `retrieve-incident-custom-fields` | `pagerduty.retrieveIncidentCustomFields()` | — | 1 | Retrieves a list of custom fields associated with incidents in PagerDuty |
| `retrieve-incident-field-options` | `pagerduty.retrieveIncidentFieldOptions()` | `--field-id` | 0 | Retrieves the available field options for a specific custom incident field in PagerDuty |
| `retrieve-incident-workflow-by-id` | `pagerduty.retrieveIncidentWorkflowById()` | `--id` | 0 | Retrieves detailed information about a specific incident workflow in PagerDuty |
| `retrieve-incident-workflow-triggers` | `pagerduty.retrieveIncidentWorkflowTriggers()` | — | 9 | Retrieves a list of triggers associated with incident workflows in PagerDuty |
| `retrieve-integration-by-service-id` | `pagerduty.retrieveIntegrationByServiceId()` | `--id` `--integration-id` | 1 | Retrieves detailed information about a specific integration associated with a particular service in PagerDuty |
| `retrieve-license-allocations` | `pagerduty.retrieveLicenseAllocations()` | — | 2 | Retrieves the current license allocations for the PagerDuty account, showing which users have been allocated which licenses |
| `retrieve-list-of-services` ·common | `pagerduty.retrieveListOfServices()` | — | 9 | Retrieves a list of services configured in the PagerDuty account |
| `retrieve-log-entry-by-id` | `pagerduty.retrieveLogEntryById()` | `--id` | 2 | Retrieves detailed information about a specific log entry in the PagerDuty system |
| `retrieve-maintenance-windows` ·common | `pagerduty.retrieveMaintenanceWindows()` | — | 8 | Retrieves a list of maintenance windows from the PagerDuty incident management platform |
| `retrieve-notes-for-incident` | `pagerduty.retrieveNotesForIncident()` | `--id` | 0 | Retrieves all notes associated with a specific incident in PagerDuty |
| `retrieve-notifications` | `pagerduty.retrieveNotifications()` | `--since` `--until` | 6 | Retrieves a list of notifications sent to users in PagerDuty within a specified date range |
| `retrieve-oncall-handoff-notification-rule` | `pagerduty.retrieveOncallHandoffNotificationRule()` | `--id` `--oncall-handoff-notification-rule-id` | 0 | Retrieves detailed information about a specific on-call handoff notification rule for a given user in PagerDuty |
| `retrieve-oncall-handoff-notification-rules` | `pagerduty.retrieveOncallHandoffNotificationRules()` | `--id` | 0 | Retrieves the on-call handoff notification rules for a specific user in PagerDuty |
| `retrieve-oncall-list` | `pagerduty.retrieveOncallList()` | — | 11 | Retrieves the current on-call information for your PagerDuty account |
| `retrieve-past-incidents` | `pagerduty.retrievePastIncidents()` | `--id` | 2 | Retrieves a list of past similar incidents for a specific incident using machine learning |
| `retrieve-postmortem-by-id` | `pagerduty.retrievePostmortemById()` | `--id` `--post-id` | 0 | Retrieves the postmortem analysis for a specific post on a PagerDuty status page |
| `retrieve-response-play-by-id` | `pagerduty.retrieveResponsePlayById()` | `--id` | 0 | This endpoint has been deprecated and removed |
| `retrieve-rule-by-service-id` | `pagerduty.retrieveRuleByServiceId()` | `--id` `--rule-id` | 0 | Retrieves a specific service event rule by ID from a PagerDuty service |
| `retrieve-rules-for-service-id` | `pagerduty.retrieveRulesForServiceId()` | `--id` | 4 | Retrieves all rules associated with a specific PagerDuty service |
| `retrieve-rules-from-ruleset-by-id` | `pagerduty.retrieveRulesFromRulesetById()` | `--id` | 3 | Retrieves a list of event rules associated with a specific ruleset in PagerDuty |
| `retrieve-ruleset-by-id` | `pagerduty.retrieveRulesetById()` | `--id` | 0 | Retrieves detailed information about a specific ruleset in PagerDuty using its unique identifier |
| `retrieve-ruleset-list` | `pagerduty.retrieveRulesetList()` | — | 3 | Retrieves a list of rulesets from the PagerDuty system |
| `retrieve-schedule-audit-records-by-id` | `pagerduty.retrieveScheduleAuditRecordsById()` | `--id` | 4 | Retrieves the audit records for a specific PagerDuty schedule |
| `retrieve-schedule-by-id` | `pagerduty.retrieveScheduleById()` | `--id` | 4 | Retrieves detailed information about a specific schedule in PagerDuty using its unique identifier |
| `retrieve-schedule-override-by-id` | `pagerduty.retrieveScheduleOverrideById()` | `--id` `--since` `--until` | 2 | Lists all schedule overrides for a specific schedule within a date range |
| `retrieve-service-audit-records-by-id` | `pagerduty.retrieveServiceAuditRecordsById()` | `--id` | 4 | Retrieves the audit records for a specific PagerDuty service |
| `retrieve-service-by-id` | `pagerduty.retrieveServiceById()` | `--id` | 1 | Retrieves detailed information about a specific PagerDuty service using its unique identifier |
| `retrieve-service-change-events-by-id` | `pagerduty.retrieveServiceChangeEventsById()` | `--id` | 7 | Retrieves change events associated with a specific PagerDuty service |
| `retrieve-service-impacts-from-status-dashboards` | `pagerduty.retrieveServiceImpactsFromStatusDashboards()` | `--id` | 1 | Retrieves the service impacts associated with a specific status dashboard in PagerDuty |
| `retrieve-service-status-by-id` | `pagerduty.retrieveServiceStatusById()` | `--id` | 0 | Retrieves a list of services associated with a specific status page in PagerDuty |
| `retrieve-service-status-page` | `pagerduty.retrieveServiceStatusPage()` | `--id` `--service-id` | 0 | Retrieves detailed information about a specific service associated with a particular status page in PagerDuty |
| `retrieve-standards-list` | `pagerduty.retrieveStandardsList()` | — | 2 | Retrieves the current set of Service Standards defined in the PagerDuty account |
| `retrieve-standards-scores` | `pagerduty.retrieveStandardsScores()` | `--id` `--resource-type` | 0 | Retrieves the standards scores for a specific technical service in PagerDuty |
| `retrieve-standards-scores-by-resource-type` | `pagerduty.retrieveStandardsScoresByResourceType()` | `--ids` `--resource-type` | 0 | Retrieves the standards scores for a specified resource type in PagerDuty |
| `retrieve-status-dashboard-by-slug` | `pagerduty.retrieveStatusDashboardBySlug()` | `--url-slug` | 0 | Retrieves detailed information about a specific PagerDuty status dashboard using its URL slug |
| `retrieve-status-dashboards-information` | `pagerduty.retrieveStatusDashboardsInformation()` | — | 2 | Retrieves a list of status dashboards and their associated information from the PagerDuty system |
| `retrieve-status-page-post` | `pagerduty.retrieveStatusPagePost()` | `--id` | 3 | Retrieves all posts associated with a specific status page in PagerDuty |
| `retrieve-status-page-severities-by-id` | `pagerduty.retrieveStatusPageSeveritiesById()` | `--id` | 1 | Retrieves the list of severities associated with a specific status page in PagerDuty |
| `retrieve-status-page-subscription-by-id` | `pagerduty.retrieveStatusPageSubscriptionById()` | `--id` | 2 | Retrieves a list of subscriptions associated with a specific PagerDuty status page |
| `retrieve-status-pages-status` | `pagerduty.retrieveStatusPagesStatus()` | `--id` | 1 | Retrieves the current statuses for a specified PagerDuty status page |
| `retrieve-tag-by-id` | `pagerduty.retrieveTagById()` | `--id` | 0 | Retrieves detailed information about a specific tag in the PagerDuty system using its unique identifier |
| `retrieve-tags` | `pagerduty.retrieveTags()` | — | 4 | Retrieves a list of tags from your PagerDuty account with optional filtering and pagination |
| `retrieve-team-audit-records` | `pagerduty.retrieveTeamAuditRecords()` | `--id` | 4 | Retrieves the audit records for a specific team in PagerDuty |
| `retrieve-team-details-by-id` | `pagerduty.retrieveTeamDetailsById()` | `--id` | 1 | Retrieves detailed information about a specific team in PagerDuty based on the provided team ID |
| `retrieve-team-list` | `pagerduty.retrieveTeamList()` | — | 4 | The ListTeams endpoint retrieves a list of teams within a PagerDuty account |
| `retrieve-technical-service-details` | `pagerduty.retrieveTechnicalServiceDetails()` | `--id` | 0 | Retrieves detailed information about a specific technical service and its dependencies within the PagerDuty incident management platform |
| `retrieve-template-fields` | `pagerduty.retrieveTemplateFields()` | — | 0 | Retrieves the available field definitions for PagerDuty status update templates |
| `retrieve-unrouted-event-orchestration-by-id` | `pagerduty.retrieveUnroutedEventOrchestrationById()` | `--id` | 0 | Retrieves the unrouted orchestration configuration for a specific Event Orchestration in PagerDuty |
| `retrieve-user-audit-records-by-id` | `pagerduty.retrieveUserAuditRecordsById()` | `--id` | 4 | Retrieves the audit records for a specific user in the PagerDuty system |
| `retrieve-user-by-id` | `pagerduty.retrieveUserById()` | `--id` | 1 | Retrieves detailed information about a specific PagerDuty user by their ID |
| `retrieve-user-contact-methods-via-id` | `pagerduty.retrieveUserContactMethodsViaId()` | `--id` | 0 | Retrieves all contact methods associated with a specific user in PagerDuty |
| `retrieve-user-license-information` | `pagerduty.retrieveUserLicenseInformation()` | `--id` | 0 | Retrieves the license information for a specific user in the PagerDuty system |
| `retrieve-user-notification-rule` | `pagerduty.retrieveUserNotificationRule()` | `--id` `--notification-rule-id` | 1 | Retrieves a specific notification rule for a given user in PagerDuty |
| `retrieve-user-notification-rules` | `pagerduty.retrieveUserNotificationRules()` | `--id` | 2 | Retrieves the notification rules for a specific user in PagerDuty |
| `retrieve-user-status-update-notification-rule` | `pagerduty.retrieveUserStatusUpdateNotificationRule()` | `--id` `--status-update-notification-rule-id` | 1 | Retrieves a specific status update notification rule for a given user in PagerDuty |
| `retrieve-users-by-schedule-id` | `pagerduty.retrieveUsersByScheduleId()` | `--id` | 2 | Retrieves a list of users associated with a specific PagerDuty schedule |
| `retrieve-users-list` ·common | `pagerduty.retrieveUsersList()` | — | 6 | Retrieves a list of users from the PagerDuty system |
| `retrieve-vendor-by-id` | `pagerduty.retrieveVendorById()` | `--id` | 0 | Get detailed information about a specific PagerDuty vendor integration by its ID |
| `retrieve-webhook-subscriptions` | `pagerduty.retrieveWebhookSubscriptions()` | — | 5 | Retrieves a list of all webhook subscriptions associated with the authenticated PagerDuty account |
| `send-mcp-request` | `pagerduty.sendMcpRequest()` | `--id` `--method` | 2 | Send JSON-RPC requests to PagerDuty's Model Context Protocol (MCP) endpoint |
| `send-responder-requests-for-incidents` | `pagerduty.sendResponderRequestsForIncidents()` | `--id` `--message` `--requester-id` `--responder-request-targets` | 0 | Send responder requests to users or escalation policies for a PagerDuty incident |
| `set-business-service-impact-status` | `pagerduty.setBusinessServiceImpactStatus()` | `--business-service-id` `--id` `--relation` | 0 | This endpoint updates the impact status of a specific incident on a particular business service in PagerDuty |
| `set-global-priority-threshold` | `pagerduty.setGlobalPriorityThreshold()` | — | 2 | Sets the global Priority Threshold for Business Services in PagerDuty, determining which incidents can impact these services based on their priority level |
| `snooze-incident-by-duration` | `pagerduty.snoozeIncidentByDuration()` | `--duration` `--id` | 1 | Snooze an acknowledged incident in PagerDuty for a specified duration |
| `subscribe-entities-to-business-services` | `pagerduty.subscribeEntitiesToBusinessServices()` | `--id` `--subscribers` | 0 | This endpoint allows you to subscribe users or teams to a specific business service in PagerDuty |
| `subscribe-entities-to-incident-status-updates` | `pagerduty.subscribeEntitiesToIncidentStatusUpdates()` | `--id` `--subscribers` | 0 | Subscribes specified users or teams to receive status updates for a particular incident in PagerDuty |
| `subscribe-to-user-notifications` | `pagerduty.subscribeToUserNotifications()` | `--id` `--subscribables` | 0 | Creates notification subscriptions for a specific user in PagerDuty |
| `unsubscribe-business-service-entity` | `pagerduty.unsubscribeBusinessServiceEntity()` | `--id` `--subscribers` | 0 | This endpoint unsubscribes specified users or teams from receiving notifications for a particular business service in PagerDuty |
| `unsubscribe-from-incident-status-updates` | `pagerduty.unsubscribeFromIncidentStatusUpdates()` | `--id` `--subscribers` | 0 | Unsubscribes specified users or teams from receiving status updates for a particular incident in PagerDuty |
| `unsubscribe-team-notification-subscriptions` | `pagerduty.unsubscribeTeamNotificationSubscriptions()` | `--id` `--subscribables` | 0 | Unsubscribes a team from notifications for specific incidents or business services in PagerDuty |
| `unsubscribe-user-notification-subscriptions` | `pagerduty.unsubscribeUserNotificationSubscriptions()` | `--id` `--subscribables` | 0 | This endpoint allows unsubscribing a user from notifications for specific incidents or business services in PagerDuty |
| `update-add-on-by-id` | `pagerduty.updateAddOnById()` | `--addon` `--id` | 0 | Updates an existing Add-on in PagerDuty with new properties |
| `update-alert-grouping-settings-by-id` | `pagerduty.updateAlertGroupingSettingsById()` | `--id` | 8 | Update an existing Alert Grouping Setting in PagerDuty by its ID |
| `update-alert-in-incident` | `pagerduty.updateAlertInIncident()` | `--alert--incident--id` `--alert-id` `--id` | 2 | Updates the status of a specific alert within an incident in PagerDuty |
| `update-automation-runner-info` | `pagerduty.updateAutomationRunnerInfo()` | `--id` `--runner` | 0 | This endpoint allows you to update an existing Automation Action Runner in PagerDuty |
| `update-business-service-by-id` | `pagerduty.updateBusinessServiceById()` | `--id` | 4 | This endpoint allows you to update an existing Business Service in PagerDuty |
| `update-change-event-by-id` | `pagerduty.updateChangeEventById()` | `--change-event` `--id` | 0 | Update an existing change event in PagerDuty by its unique ID |
| `update-custom-field-display-name` | `pagerduty.updateCustomFieldDisplayName()` | `--field-id` | 3 | Updates an existing custom field for incidents in PagerDuty |
| `update-custom-field-for-incident-type` | `pagerduty.updateCustomFieldForIncidentType()` | `--field-id` `--type-id-or-name` | 4 | Update a custom field for an incident type |
| `update-custom-field-option` | `pagerduty.updateCustomFieldOption()` | `--field-id` `--field-option-id` `--type-id-or-name` | 2 | Updates a field option for a custom field on an incident type in PagerDuty |
| `update-escalation-policy-by-id` | `pagerduty.updateEscalationPolicyById()` | `--escalation-policy` `--id` | 0 | Updates an existing escalation policy in PagerDuty with new settings and rules |
| `update-escalation-policy-for-team` | `pagerduty.updateEscalationPolicyForTeam()` | `--escalation-policy-id` `--id` | 0 | Associates an escalation policy with a team in PagerDuty |
| `update-event-orchestration-by-id` | `pagerduty.updateEventOrchestrationById()` | `--id` | 18 | Updates an existing Event Orchestration in PagerDuty |
| `update-event-orchestration-cache-variable` | `pagerduty.updateEventOrchestrationCacheVariable()` | `--cache-variable-id` `--service-id` | 13 | This endpoint updates a cache variable associated with a specific service in PagerDuty's event orchestrations |
| `update-event-rule-by-id` | `pagerduty.updateEventRuleById()` | `--id` `--rule-id` | 1 | This endpoint allows you to update an existing Event Rule within a specified Ruleset in PagerDuty |
| `update-event-rule-for-service` | `pagerduty.updateEventRuleForService()` | `--id` `--rule-id` | 1 | This endpoint allows you to update an existing Event Rule for a specific service in PagerDuty |
| `update-extension-by-id` | `pagerduty.updateExtensionById()` | `--extension` `--id` | 0 | Updates an existing extension in PagerDuty |
| `update-global-orchestration` | `pagerduty.updateGlobalOrchestration()` | `--id` `--orchestration-path` | 0 | Update the Global Orchestration configuration for an Event Orchestration |
| `update-incident-alerts` | `pagerduty.updateIncidentAlerts()` | `--alerts` `--id` | 3 | This endpoint allows you to update the status of multiple alerts associated with a specific incident in PagerDuty |
| `update-incident-by-id` | `pagerduty.updateIncidentById()` | `--id` | 11 | The UpdateIncident endpoint allows you to modify various attributes of an existing incident in PagerDuty's incident management system |
| `update-incident-custom-field-values` | `pagerduty.updateIncidentCustomFieldValues()` | `--custom-fields` `--id` | 0 | Updates custom field values for a specific incident in PagerDuty |
| `update-incident-details` | `pagerduty.updateIncidentDetails()` | `--incidents` | 3 | This endpoint allows for bulk updating of multiple PagerDuty incidents in a single API call |
| `update-incident-type` | `pagerduty.updateIncidentType()` | `--type-id-or-name` | 3 | Update an Incident Type |
| `update-incident-workflow` | `pagerduty.updateIncidentWorkflow()` | `--id` `--incident-workflow` | 0 | This endpoint updates an existing Incident Workflow in PagerDuty by its unique identifier |
| `update-integration-by-id-and-integration-id` | `pagerduty.updateIntegrationByIdAndIntegrationId()` | `--id` `--integration` `--integration-id` | 0 | Updates an existing integration for a specific PagerDuty service |
| `update-integration-label` | `pagerduty.updateIntegrationLabel()` | `--id` `--integration-id` | 1 | This endpoint updates the label (name) of an integration associated with a specific event orchestration in PagerDuty |
| `update-log-entry-channel` | `pagerduty.updateLogEntryChannel()` | `--channel--details` `--channel--type` `--id` | 0 | Updates collaboration channel information for a specific log entry in PagerDuty |
| `update-maintenance-window-by-id` | `pagerduty.updateMaintenanceWindowById()` | `--id` `--maintenance-window` | 0 | Updates an existing maintenance window in PagerDuty's incident management system |
| `update-oncall-handoff-notification-rule` | `pagerduty.updateOncallHandoffNotificationRule()` | `--id` `--oncall--handoff--notification--rule--contact--method` `--oncall-handoff-notification-rule-id` | 3 | This endpoint updates an existing on-call handoff notification rule for a specific user in PagerDuty |
| `update-orchestration-router-details` | `pagerduty.updateOrchestrationRouterDetails()` | `--id` `--orchestration-path` | 0 | Updates the configuration of an existing Event Orchestration Router in PagerDuty |
| `update-response-play-by-id` | `pagerduty.updateResponsePlayById()` | `--id` | 8 | Updates an existing Response Play in PagerDuty's incident management system |
| `update-ruleset-by-id` | `pagerduty.updateRulesetById()` | `--id` | 16 | Updates an existing ruleset in the PagerDuty incident management system |
| `update-schedule-by-id` | `pagerduty.updateScheduleById()` | `--id` `--schedule` | 1 | The UpdateSchedule endpoint modifies an existing on-call schedule in PagerDuty |
| `update-service-by-id` ·common | `pagerduty.updateServiceById()` | `--id` `--service` | 0 | Updates an existing service in PagerDuty with the provided configuration |
| `update-service-orchestration-active-status` | `pagerduty.updateServiceOrchestrationActiveStatus()` | `--active` `--service-id` | 0 | Update the active status of a service orchestration in PagerDuty |
| `update-service-orchestration-for-service` | `pagerduty.updateServiceOrchestrationForService()` | `--orchestration-path` `--service-id` | 0 | Update a Service Orchestration for a service |
| `update-standard-by-id` | `pagerduty.updateStandardById()` | `--id` | 4 | Updates an existing standard in the PagerDuty incident management platform |
| `update-status-page-post` | `pagerduty.updateStatusPagePost()` | `--id` `--post-id` `--post-update-id` | 13 | Updates an existing status page post update with new information |
| `update-status-page-post-info` | `pagerduty.updateStatusPagePostInfo()` | `--id` `--post--update--impacted--services` `--post--update--message` `--post--update--notify--subscribers` `--post--update--post--id` `--post--update--severity--id` `--post--update--status--id` `--post--update--type` `--post--update--update--frequency--ms` `--post-id` | 5 | Creates or updates a post update on a specific PagerDuty status page |
| `update-status-page-post-postmortem` | `pagerduty.updateStatusPagePostPostmortem()` | `--id` `--post-id` `--postmortem--message` `--postmortem--notify--subscribers` `--postmortem--post--id` | 2 | Legacy duplicate of `create_or_update_status_page_postmortem` |
| `update-status-page-post-resource` | `pagerduty.updateStatusPagePostResource()` | `--id` `--post-id` | 7 | Updates an existing status page post on a PagerDuty Status Page |
| `update-team-by-id` | `pagerduty.updateTeamById()` | `--id` `--team` | 0 | Updates an existing team in PagerDuty by modifying its name, description, visibility, or parent team |
| `update-template-by-id` | `pagerduty.updateTemplateById()` | `--id` | 6 | The UpdateTemplate endpoint allows you to modify an existing status update template in PagerDuty |
| `update-trigger` | `pagerduty.updateTrigger()` | `--id` `--trigger` | 0 | Updates an existing incident workflow trigger in PagerDuty |
| `update-unrouted-orchestration-rules` | `pagerduty.updateUnroutedOrchestrationRules()` | `--id` `--orchestration-path` | 0 | Updates the unrouted orchestration rules for a specific Event Orchestration in PagerDuty |
| `update-user-information` | `pagerduty.updateUserInformation()` | `--id` `--user` | 0 | Updates an existing user's information in PagerDuty |
| `update-user-notification-rule-by-id` | `pagerduty.updateUserNotificationRuleById()` | `--id` `--status-update-notification-rule` `--status-update-notification-rule-id` | 0 | Updates a specific status update notification rule for a PagerDuty user |
| `update-user-role-on-team` | `pagerduty.updateUserRoleOnTeam()` | `--id` `--role` `--user-id` | 0 | Adds a user to a team or updates their role on a team |
| `update-workflow-integration-connection` | `pagerduty.updateWorkflowIntegrationConnection()` | `--id` `--integration-id` | 11 | Update an existing Workflow Integration Connection |

## Docs

- [run CLI](https://docs.boxd.sh/cli/run): Call connected integrations from the shell, connect new ones, and run automations.
- [Quickstart](https://docs.boxd.sh/guides/integrations/quickstart): Connect an integration, call it from the shell, and turn a script into an automation.
- [Connections](https://docs.boxd.sh/guides/integrations/connections): Connect an account once, for yourself or for your whole organization.
- [Scripts](https://docs.boxd.sh/guides/automations/scripts): Typed integrations, triggers, schedules and state in a .run.ts file.
- [Jobs](https://docs.boxd.sh/guides/automations/jobs): How a script becomes a background job: states, retries, sleep and wake.
- [Beyond the catalog](https://docs.boxd.sh/guides/automations/beyond-the-catalog): Reach your own APIs, databases and cloud accounts from a script.
