Skip to main content

Overview

Retrieves detailed information about a specific alert within an incident. Use this tool when you need to examine the full details of a particular alert.
This is a read-only tool. It retrieves data without modifying your PagerDuty account.

Parameters

incident_id
string
required
The ID of the incident containing the alert.Example: Q1XQPZ3PYQ0ABC
alert_id
string
required
The ID of the alert to retrieve.Example: PALERT123ABC

Response

Returns a single Alert object with complete details.
id
string
required
The unique identifier for the alert.
type
string
required
The type of the object (always "alert").
summary
string
required
A short summary of the alert.
self
string
required
The API URL at which this alert is accessible.
html_url
string
required
The URL at which this alert is accessible in the PagerDuty UI.
created_at
datetime
required
The date/time when this alert was created.
status
string
required
The current status of the alert (e.g., triggered, resolved).
alert_key
string
required
The unique key identifying this alert.
service
ServiceReference
Reference to the service this alert is associated with.
incident
IncidentReference
Reference to the incident this alert is associated with.
body
AlertBody
The detailed body of the alert.
severity
string
The severity level of the alert (e.g., critical, error, warning, info).
suppressed
boolean
Whether the alert is suppressed.
integration
IntegrationReference
Reference to the integration that created this alert.

Example Usage

Show me alert PALERT123ABC from incident Q1XQPZ3PYQ0ABC

Example Response

{
  "id": "PALERT123ABC",
  "type": "alert",
  "summary": "High CPU usage on web-server-01",
  "self": "https://api.pagerduty.com/alerts/PALERT123ABC",
  "html_url": "https://myaccount.pagerduty.com/alerts/PALERT123ABC",
  "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",
    "contexts": [],
    "details": {
      "cpu_usage": "95%",
      "hostname": "web-server-01",
      "timestamp": "2024-03-15T14:30:00Z",
      "metric": "system.cpu.usage"
    }
  },
  "severity": "critical",
  "suppressed": false,
  "integration": {
    "id": "PINTEGRATION1",
    "type": "inbound_integration_reference",
    "summary": "Datadog Integration",
    "self": "https://api.pagerduty.com/services/PSERVICE1/integrations/PINTEGRATION1",
    "html_url": "https://myaccount.pagerduty.com/services/PSERVICE1/integrations/PINTEGRATION1"
  }
}

list_alerts_from_incident

List all alerts for an incident

get_incident

Get incident details

Build docs developers (and LLMs) love