# List Related Change Events for an Incident

Lists change events correlated with an incident, along with the reason PagerDuty linked each change to that specific incident.


> **Availability:** See the [Incident Workflow Actions Overview table](/workflow-actions) for the plans this workflow is available on.

## Description

Lists related Change Events for an incident, as well as the reason these changes are correlated with the incident.

## Instructions

1. If you have not done so, follow the instructions to [Create an Incident Workflow](/ai-automation/automation/incident-workflows#create-an-incident-workflow).
2. When the instructions prompt you to [add actions](/ai-automation/automation/incident-workflows#add-actions), select **this action**.
3. Enter the following **Inputs** and click **Save**.
4. Continue following instructions to **Publish** the Workflow.
5. When the action runs, you will see the **Outputs** listed below.

## Inputs

> **Field References:** Fields with the **\{+\}** icon accept [Field References](/ai-automation/automation/incident-workflows#field-references), which can be useful for referencing incident data or outputs created in prior workflow steps. To add Field References, click **\{+\}**, or enter `{{`, and select relevant fields. Refer to the [Field References](/ai-automation/automation/incident-workflows#field-references) article for more information.

<br />

| Name        | Description                                                                                         |
| :---------- | :-------------------------------------------------------------------------------------------------- |
| Incident ID | The ID of the Incident whose related Change Events will be returned. Defaults to `{{incident.id}}`. |

## Outputs

| Name                               | Description                                                                                                                                                         |
| :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Number of Change Events            | The total number of Change Events related to the incident                                                                                                           |
| Change Events                      | The JSON-formatted list of Change Events. **Note**: This JSON will exactly match the value of the `change_events` property returned from the endpoint linked below. |
| Timestamp of Last Change Event     | The timestamp of the most recent Change Event                                                                                                                       |
| Summary of Last Change Event       | A brief summary of the most recent Change Event                                                                                                                     |
| Source of Last Change Event        | The source of the most recent Change Event                                                                                                                          |
| Result                             | Value that shows if the action was successful or not. Either "Success" or "Failed."                                                                                 |
| Result Summary                     | Brief description of what the action did or if it failed.                                                                                                           |
| Error                              | Brief description that populates if the action failed.                                                                                                              |

## PagerDuty API Endpoint

Endpoint used:

- [List related Change Events for an Incident](/developer/api/reference/rest/change-events/list-incident-related-change-events)