Read Incident

Access information on an incident in your PagerDuty instance.

Unless otherwise indicated, field type is text.

Input Fields

Ready By

• Incident Key: Parameter that identifies the incident to which a PagerDuty trigger event was applied. An incident key is assigned to an incident to help prevent duplication.

Output Fields

Incident

• Name: short description assigned to an incident
• Incident ID: identifier that you can assign to an incident
• Incident Number (number): numeric identifier automatically assigned to an incident in your PagerDuty instance
• Created At: date and time when an incident was created
• Status: one of three states for an incident - Triggered, Acknowledged, or Resolved
• Pending Actions (list of objects):
  • Type: Options that determine how incidents are dealt with once they are triggered - unacknowledge, escalate, resolve, or urgency_change.
  • At: The number of minutes after which a one of the four options on triggered incidents takes effect
• Urgency: feature that determines how a team is notified based on the criticality of an incident
  • High: requires immediate attention
  • Low: does not require prompt action
• Type: type of integration that can be used to trigger an incident. Type can be incident or incident_reference.
• URL: URL to view an incident in your PagerDuty instance

Service

• Name: name of a service (Example: application or component) against which incidents are opened
• Service ID: unique identifier of a service
• Type: type of integration for the service. A type can be service or service_reference.
• URL: URL of an integrated application or component within your PagerDuty instance

Escalation Policy

• Escalation Policy ID: Identifier that is automatically assigned to an escalation policy. An escalation policy ensures the right people are notified at the right time when an incident occurs.
  
• Type: Type of escalation policy. Type can be escalation_policy or escalation_policy_reference.
• Summary: description of the escalation policy, including user and schedule targets
• URL: URL to view an escalation policy within your PagerDuty instance

Last Status Change

• Updated At: date and time of the latest update to an incident
• Updated By ID: the identifier of the person who made the latest udpate to an incident
• Type: the method by which an incident was updated - email or API
• Name: the name of the service against which an incident was updated
• URL: URL of the updated incident