past_incidents

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

Overview

Name	past_incidents
Type	Resource
Id	pagerduty.incidents.past_incidents

Fields

The following fields are returned by SELECT queries:

list

Name	Datatype	Description
incident	object	Incident model reference
score	number	The computed similarity score associated with the incident and parent incident

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	id	limit, total	Past Incidents returns Incidents within the past 6 months that have similar metadata and were generated on the same Service as the parent Incident. By default, 5 Past Incidents are returned. 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#past_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.
limit	integer	The number of results to be returned in the response.
total	boolean	By default the total field in the response body is set to null to provide the fastest possible response times. Set total to true for this field to be populated with the total number of Past Incidents.

SELECT examples

list

Past Incidents returns Incidents within the past 6 months that have similar metadata and were generated on the same Service as the parent Incident. By default, 5 Past Incidents are returned. 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#past_incidents)<br /><br />Scoped OAuth requires: incidents.read<br />

SELECT
incident,
score
FROM pagerduty.incidents.past_incidents
WHERE id = '{{ id }}' -- required
AND limit = '{{ limit }}'
AND total = '{{ total }}'
;