Read Incident

Access information on an incident in your PagerDuty instance.

Input

Field Definition Type Required
Incident Key Unique key that identifies the incident to which a PagerDuty trigger event was applied. An incident key is assigned to an incident to help prevent duplication. String TRUE

Output

Field Definition Type
Incident
Name A short description of the incident String
Incident ID Identifier that you can assign to an incident String
Incident Number Numeric identifier automatically assigned to the incident in your PagerDuty instance Number
Created At Date and time when the incident was created String
Status State of the incident: Triggered, Acknowledged, or Resolved. String
Pending Actions
Type Options that determine how incidents are dealt with once they are triggered: unacknowledge, escalate, resolve, or urgency_change. String
At Number of minutes after which one of the four options on triggered incidents takes effect String
Urgency

This feature determines how a team is notified based on the criticality of an incident:

  • High: The incident requires immediate attention.
  • Low: The incident does not require prompt action.
String
Type Type of integration that can be used to trigger an incident. The type can be incident or incident_reference. String
URL URL to view an incident in your PagerDuty instance. String
Service
Name Name of a service against which incidents are opened. For example, an application or component. String
Service ID Unique identifier of the of a service String
Type Type of integration for the service. The type can be service or service_reference. String
URL URL of an integrated application or component within your PagerDuty instance String
Escalation Policy
Escalation Policy ID Identifier that was automatically assigned to the escalation policy. An escalation policy ensures the right people are notified at the right time when an incident occurs. String
Type Type of escalation policy. The type can be escalation_policy or escalation_policy_reference. String
Summary Description of the escalation policy, including user and schedule targets String
URL URL to view an escalation policy within your PagerDuty instance String
Last Status Change
Updated At Date and time of the latest update to an incident String
Updated By ID Identifier of the person who made the latest update to an incident String
Type Method by which an incident was updated; either email or API String
Name Name of the service against which an incident was updated String
URL URL of the updated incident String

Related topics