related_incidents

Creates, updates, deletes, gets or lists a related_incidents resource.

Overview

Name	related_incidents
Type	Resource
Id	pagerduty.incidents.related_incidents

Fields

The following fields are returned by SELECT queries:

list

A list of Related Incidents and their relationships.

Name	Datatype	Description
incident	object
relationships	array	A list of reasons for why the Incident is considered related.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	id	additional_details[]	Returns the 20 most recent Related Incidents that are impacting other Responders and Services. Note: This feature is currently available as part of the Event Intelligence package or Digital Operations plan only.<br /><br />For more information see the [API Concepts Document](https:​//developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#related_incidents)<br /><br />Scoped OAuth requires: incidents.read<br />

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
id	string	The ID of the resource.
additional_details[]	string	Array of additional attributes to any of the returned incidents for related incidents.

SELECT examples

list

Returns the 20 most recent Related Incidents that are impacting other Responders and Services. Note: This feature is currently available as part of the Event Intelligence package or Digital Operations plan only.<br /><br />For more information see the [API Concepts Document](https:​//developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#related_incidents)<br /><br />Scoped OAuth requires: incidents.read<br />

SELECT
incident,
relationships
FROM pagerduty.incidents.related_incidents
WHERE id = '{{ id }}' -- required
AND additional_details[] = '{{ additional_details[] }}'
;