younifyd
Menu

Update Incidents

Manage incidents

PUT/incidents

Use it in a workflow

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

Request

Query parameters

limitinteger

The number of results per page.

offsetinteger

Offset to start pagination search results.

totalboolean

By default the `total` field in pagination responses is set to `null` to provide the fastest possible response times. Set `total` to `true` for this field to be populated. See our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information.

Default false

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.

incidentsarray<object>required

An array of incidents, including the parameters to update.

idstringrequired

The id 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

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

A succinct description of the nature, symptoms, cause, or effect of the incident.

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.

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
json
{
  "incidents": [
    {
      "id": "string",
      "type": "incident",
      "status": "resolved",
      "resolution": "string",
      "title": "string",
      "priority": null,
      "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"
      }
    }
  ]
}

Response

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

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