younifyd
Menu

Update Incident

Update an incident

PUT/incidents/{id}

Use it in a workflow

  1. Add a step and choose the PagerDuty connector.
  2. Pick the Update Incident action (under Incidents).
  3. Fill in the fields below, then reference the result from later steps as {{updateIncident.response.data}}.

Request

Path parameters

idstringrequired

The ID of the resource.

Headers

Acceptstringrequired

The `Accept` header is used as a versioning header.

Default "application/vnd.pagerduty+json;version=2"

Content-Typestringrequired

One ofapplication/jsonDefault "application/json"

Fromstring (email)required

The email address of a valid user associated with the account making the request.

Request body

Enter the body as JSON in the step's Body field.

incidentobjectrequired

The parameters of the incident to update.

typestringrequired

The incident type.

One ofincidentincident_reference

statusstring

The new status of the incident. If the incident is currently resolved, setting the status to "triggered" or "acknowledged" will reopen it. When reopening an incident to the "triggered" status, it will be assigned based on the assignees or escalation_policy fields in the request, otherwise it will be assigned to the current Escalation Policy. When reopening an incident to the "acknowledged" status, it will be assigned to the current user.

One ofresolvedacknowledgedtriggered

priorityoneOf

The priority of the incident. Can be provided as a priority object or a string matching a priority name. If a string is provided, the highest priority with a matching name will be used.

resolutionstring

The resolution for this incident. This field is used only when setting the incident status to resolved. The value provided here is added to the incident’s 'Resolve' log entry as a note and will not be displayed directly in the UI.

titlestring

The new title of the incident.

escalation_levelinteger

Escalate the incident to this level in the escalation policy.

assignmentsarray<object>1 fields

Assign the incident to these assignees.

incident_typeobject2 fields
escalation_policyany
urgencystring

The urgency of the incident.

One ofhighlow

conference_bridgeobject2 fields
serviceobject2 fields

Assign the incident to this service.

json
{
  "incident": {
    "type": "incident",
    "status": "resolved",
    "priority": null,
    "resolution": "string",
    "title": "string",
    "escalation_level": 0,
    "assignments": [
      {
        "assignee": null
      }
    ],
    "incident_type": {
      "id": "string",
      "name": "string"
    },
    "escalation_policy": null,
    "urgency": "high",
    "conference_bridge": {
      "conference_number": "string",
      "conference_url": "string"
    },
    "service": {
      "id": "string",
      "type": "service_reference"
    }
  }
}

Response

Returns 200 with a any. Read it in later steps with {{updateIncident.response.data.<field>}}.

Need more? See the PagerDuty guide for connection setup and behaviour shared by every action.