---
title: Update a PagerDuty incident
source: https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/pagerduty/pagerduty-incident-update
---

For prerequisites, see [PagerDuty incident actions](https://docs.newrelic.com/docs/workflow-automation/setup-and-configure/actions-catalog/pagerduty/pagerduty-incident#prerequisites).

## Update a PagerDuty incident

The action identifier is `pagerduty.incident.update`.

Updates an existing PagerDuty incident's properties such as status, priority, title, assignments, and other attributes.

### Inputs

The following table describes all available input fields for this action.

| Input                | Type    | Description                                                                                                            | Example                                                                           |
| -------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| **token**            | String  | **Required.** PagerDuty API token.                                                                                     | `${{ :secrets:pagerdutyApiToken }}`                                               |
| **incidentId**       | String  | **Required.** The ID of the incident to update.                                                                        | `"1234567"`                                                                       |
| **type**             | String  | **Required.** Must be `"incident"`.                                                                                    | `"incident"`                                                                      |
| **from**             | String  | **Optional.** Required for account tokens, optional for user tokens. The email address of the user making the request. | `abc@example.com`                                                                 |
| **status**           | String  | **Optional.** New incident status: `acknowledged` or `resolved`.                                                       | `"acknowledged"`                                                                  |
| **title**            | String  | **Optional.** New incident title.                                                                                      | `"Test Incident 2"`                                                               |
| **priority**         | Map     | **Optional.** Priority reference.                                                                                      | `{"id": "P53ZZH5", "type": "priority_reference"}`                                 |
| **urgency**          | String  | **Optional.** Incident urgency: `low` or `high`.                                                                       | `"low"`                                                                           |
| **assignments**      | List    | **Optional.** List of assignee objects.                                                                                | `[{"assignee": {"id": "P11223", "type": "user_reference"}}]`                      |
| **escalationLevel**  | Integer | **Optional.** Escalation level.                                                                                        | `1`                                                                               |
| **incidentType**     | Map     | **Optional.** Incident type name.                                                                                      | `{"name": "major_incident"}`                                                      |
| **escalationPolicy** | Map     | **Optional.** Escalation policy reference.                                                                             | `{"id": "PT20YPA", "type": "escalation_policy_reference"}`                        |
| **service**          | Map     | **Optional.** Service reference.                                                                                       | `{"id": "PV5L94Z", "type": "service_reference"}`                                  |
| **conferenceBridge** | Map     | **Optional.** Conference bridge details.                                                                               | `{"conference_number": "+1 1234567890", "conference_url": "https://someUrl.com"}` |
| **resolution**       | String  | **Optional.** Resolution note.                                                                                         | `"resolved"`                                                                      |
| **selectors**        | List    | **Optional.** JQ selectors to extract fields from the output.                                                          | `[{"name": "incidentId", "expression": ".responseBody | fromjson.incident.id"}]`  |

### Outputs

The following table describes all output fields returned by this action.

| Output           | Type    | Description                                  |
| ---------------- | ------- | -------------------------------------------- |
| **success**      | Boolean | `true` on success, `false` on failure.       |
| **response**     | Object  | The updated incident object.                 |
| **errorMessage** | String  | Error message on failure. `null` on success. |

### Example

The following example updates a PagerDuty incident's status and title.

| Workflow example                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| ```yaml name: update-pagerduty-incident description: Update a PagerDuty incident status and title steps:   - name: pagerduty_incident_update_1     type: action     action: pagerduty.incident.update     version: 1     inputs:       token: ${{ :secrets:pagerdutyApiToken }}       type: incident       incidentId: Q1234567890123       status: acknowledged       title: Incident Title Updated       urgency: low       service:         id: P123456         type: service_reference     next: end ``` |
