Update an alert

Resolve an alert or associate an alert with a new parent incident.

An incident represents a problem or an issue that needs to be addressed and resolved.

When a service sends an event to PagerDuty, an alert and corresponding incident is triggered in PagerDuty.

For more information see the API Concepts Document

Scoped OAuth requires: incidents.write

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Path Parameters

id*string

The ID of the resource.

alert_id*string

The id of the alert to retrieve.

Header Parameters

Accept*string

The Accept header is used as a versioning header.

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

Content-Type*"application/json"

Default"application/json"

Value in

"application/json"

From*string

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

Formatemail

Request Body

application/json

The parameters of the alert to update.

TypeScript Definitions

Use the request body type in TypeScript.

alert*

Response Body

`application/json`

curl -X PUT "https://api.pagerduty.com/incidents/{id}/alerts/{alert_id}" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json" \  -H "From: user@example.com" \  -H "Content-Type: application/json" \  -d '{    "alert": {      "type": "alert",      "status": "resolved",      "incident": {        "id": "PEYSGVF",        "type": "incident_reference"      }    }  }'

{  "alert": {    "type": "alert",    "status": "resolved",    "incident": {      "id": "PEYSGVF",      "type": "incident_reference"    },    "body": {      "type": "alert_body",      "contexts": [        {          "type": "link"        }      ],      "details": {        "customKey": "Server is on fire!",        "customKey2": "Other stuff!"      }    }  }}

Update an alert

Authorization

Path Parameters

Header Parameters

Request Body

Response Body

200application/json

401application/json

403application/json

404application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`