Skip to main content

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

incident_id
string
required
The ID of the incident to retrieve alerts from.Example: Q1XQPZ3PYQ0ABC
query_model
AlertQuery
required
Query parameters for pagination and filtering.

Response

Returns a ListResponseModel[Alert] containing an array of alerts.
response
Alert[]
Array of Alert objects associated with the incident.
response_summary
string
A human-readable summary of the response including the count and type of records returned.

Example Usage

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

Build docs developers (and LLMs) love