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.

Text

TRUE

Output

Field Definition Type

Incident

Name

A short description of the incident.

Text

Incident ID

Identifier that you can assign to an incident.

Text

Incident Number Numeric identifier automatically assigned to the incident in your PagerDuty instance.

Number

Created At

Date and time when the object was created.

Text

Status State of the incident: Triggered, Acknowledged, or Resolved.

Text

Pending Actions

Type Options that determine how incidents are dealt with once they are triggered: unacknowledge, escalate, resolve, or urgency_change.

Text

At

Number of minutes after which one of the four options on triggered incidents takes effect.

Text

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.

Text

Type Type of integration that can be used to trigger an incident. The type can be incident or incident_reference.

Text

URL URL to view an incident in your PagerDuty instance.

Text

Service

Name

Name of a service against which incidents are opened. For example, an application or component.

Text

Service ID

Unique identifier of the of a service.

Text

Type Type of integration for the service. The type can be service or service_reference.

Text

URL URL of an integrated application or component within your PagerDuty instance.

Text

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.

Text

Type Type of escalation policy. The type can be escalation_policy or escalation_policy_reference.

Text

Summary

Description of the escalation policy, including user and schedule targets.

Text

URL URL to view an escalation policy within your PagerDuty instance.

Text

Last Status Change

Updated At

Date and time of the latest update to an incident.

Text

Updated By ID

Identifier of the person who made the latest update to an incident.

Text

Type

Method by which an incident was updated; either email or API.

Text

Name

Name of the service against which an incident was updated.

Text

URL

URL of the updated incident.

Text

Related topics

PagerDuty connector

Workflow elements

PagerDuty REST API