PUT /incidents/{id}
Acknowledge, resolve, escalate or reassign an incident.
An incident represents a problem or an issue that needs to be addressed and resolved.
For more information see the API Concepts Document
Scoped OAuth requires: incidents.write
Servers
- https://api.pagerduty.com
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id |
String | Yes |
The ID of the resource. |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Accept |
String | Yes |
The Default value: "application/vnd.pagerduty+json;version=2" |
Content-Type |
String | Yes |
Possible values:
Default value: "application/json" |
From |
String | Yes |
The email address of a valid user associated with the account making the request. |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
incident |
Object | Yes |
The parameters of the incident to update. |
incident.resolution |
String | No |
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. |
incident.priority |
No | ||
incident.escalation_policy |
No | ||
incident.urgency |
String | No |
The urgency of the incident. Possible values:
|
incident.escalation_level |
Integer | No |
Escalate the incident to this level in the escalation policy. |
incident.type |
String | Yes |
The incident type. Possible values:
|
incident.title |
String | No |
The new title of the incident. |
incident.service |
Object | No |
[Early Access] Assign the incident to this service. |
incident.status |
String | No |
The new status of the incident. Possible values:
|
incident.incident_type |
No | ||
incident.conference_bridge |
No | ||
incident.assignments[] |
Array | No |
Assign the incident to these assignees. |
incident.assignments[].assignee |
No |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.