Overview
Retrieves a paginated list of all alerts associated with a specific incident. This tool is useful for understanding what triggered an incident and viewing all the alert details.
This is a read-only tool. It retrieves data without modifying your PagerDuty account.
Parameters
The ID of the incident to retrieve alerts from. Example: Q1XQPZ3PYQ0ABC
Query parameters for pagination and filtering. Maximum number of results to return. Must be between 1 and 1000. Default: 100
Number of results to skip for pagination. Must be 0 or greater. Default: 0
Response
Returns a ListResponseModel[Alert] containing an array of alerts.
Array of Alert objects associated with the incident. The unique identifier for the alert.
The type of the object (always "alert").
A short summary of the alert.
The API URL at which this alert is accessible.
The URL at which this alert is accessible in the PagerDuty UI.
The date/time when this alert was created.
The current status of the alert (e.g., triggered, resolved).
The unique key identifying this alert.
Reference to the service this alert is associated with. The type (always "service_reference").
A short summary of the service.
Reference to the incident this alert is associated with. The type of the reference.
A short summary of the incident.
The API URL for the incident.
The UI URL for the incident.
The detailed body of the alert. Additional context information for the alert.
Detailed information about the alert.
The severity level of the alert (e.g., critical, error, warning, info).
Whether the alert is suppressed.
Reference to the integration that created this alert. Show IntegrationReference
The ID of the integration.
The type of the integration.
A short summary of the integration.
The API URL for the integration.
The UI URL for the integration.
A human-readable summary of the response including the count and type of records returned.
Example Usage
Natural Language
With Pagination
Show me all alerts for incident Q1XQPZ3PYQ0ABC
Example Response
{
"response" : [
{
"id" : "PALERT1" ,
"type" : "alert" ,
"summary" : "High CPU usage on web-server-01" ,
"self" : "https://api.pagerduty.com/alerts/PALERT1" ,
"html_url" : "https://myaccount.pagerduty.com/alerts/PALERT1" ,
"created_at" : "2024-03-15T14:30:00Z" ,
"status" : "triggered" ,
"alert_key" : "cpu-high-web-01" ,
"service" : {
"id" : "PSERVICE1" ,
"type" : "service_reference" ,
"summary" : "Production Web Service"
},
"incident" : {
"id" : "Q1XQPZ3PYQ0ABC" ,
"type" : "incident_reference" ,
"summary" : "High CPU usage detected" ,
"self" : "https://api.pagerduty.com/incidents/Q1XQPZ3PYQ0ABC" ,
"html_url" : "https://myaccount.pagerduty.com/incidents/Q1XQPZ3PYQ0ABC"
},
"body" : {
"type" : "alert_body" ,
"details" : {
"cpu_usage" : "95%" ,
"hostname" : "web-server-01"
}
},
"severity" : "critical" ,
"suppressed" : false
}
],
"response_summary" : "ListResponseModel<Alert>: \n - Returned 1 record(s) of type 'Alert'."
}
get_alert_from_incident Retrieve a specific alert by ID
list_incidents List all incidents