Update Incident
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 .
Parameters
Parameter | Description |
---|---|
Assign to | JSON array of PagerDuty user objects to assign this incident to. e.g. [{"assignee":{"id": "USER_ID", "type": "user_reference"}}] |
Existing Incident Type | The incident type. |
Incident Escalation Level | Escalate the incident to this level in the escalation policy. |
Incident ID | The ID of the resource. |
Incident Resolution | The resolution for this incident if status is set to resolved. |
Incident Status | The new status of the incident. |
Incident Title | The new title of the incident. |
Incident Urgency | The urgency of the incident. |
Updated by | The email address of a valid user associated with the account who is updating the incident. |
Example Output
{
"summary": "Response Example",
"value": {
"incident": {
"acknowledgements": [
{
"acknowledger": {
"html_url": "https://subdomain.pagerduty.com/users/PXPGF42",
"id": "PXPGF42",
"self": "https://api.pagerduty.com/users/PXPGF42",
"summary": "Earline Greenholt",
"type": "user_reference"
},
"at": "2015-11-10T00:32:52Z"
}
],
"assigned_via": "escalation_policy",
"assignments": [
{
"assignee": {
"html_url": "https://subdomain.pagerduty.com/users/PXPGF42",
"id": "PXPGF42",
"self": "https://api.pagerduty.com/users/PXPGF42",
"summary": "Earline Greenholt",
"type": "user_reference"
},
"at": "2015-11-10T00:31:52Z"
}
],
"created_at": "2015-10-06T21:30:42Z",
"escalation_policy": {
"html_url": "https://subdomain.pagerduty.com/escalation_policies/PT20YPA",
"id": "PT20YPA",
"self": "https://api.pagerduty.com/escalation_policies/PT20YPA",
"summary": "Another Escalation Policy",
"type": "escalation_policy_reference"
},
"first_trigger_log_entry": {
"html_url": "https://subdomain.pagerduty.com/incidents/PT4KHLK/log_entries/Q02JTSNZWHSEKV",
"id": "Q02JTSNZWHSEKV",
"self": "https://api.pagerduty.com/log_entries/Q02JTSNZWHSEKV?incident_id=PT4KHLK",
"summary": "Triggered through the API",
"type": "trigger_log_entry_reference"
},
"html_url": "https://subdomain.pagerduty.com/incidents/PT4KHLK",
"id": "PT4KHLK",
"incident_key": "baf7cf21b1da41b4b0221008339ff357",
"incident_number": 1234,
"last_status_change_at": "2015-10-06T21:38:23Z",
"last_status_change_by": {
"html_url": "https://subdomain.pagerduty.com/users/PXPGF42",
"id": "PXPGF42",
"self": "https://api.pagerduty.com/users/PXPGF42",
"summary": "Earline Greenholt",
"type": "user_reference"
},
"pending_actions": [
{
"at": "2015-11-10T01:02:52Z",
"type": "unacknowledge"
},
{
"at": "2015-11-10T04:31:52Z",
"type": "resolve"
}
],
"priority": {
"id": "P53ZZH5",
"self": "https://api.pagerduty.com/priorities/P53ZZH5",
"summary": "P2",
"type": "priority_reference"
},
"self": "https://api.pagerduty.com/incidents/PT4KHLK",
"service": {
"html_url": "https://subdomain.pagerduty.com/services/PIJ90N7",
"id": "PIJ90N7",
"self": "https://api.pagerduty.com/services/PIJ90N7",
"summary": "My Mail Service",
"type": "service_reference"
},
"status": "resolved",
"summary": "[#1234] The server is on fire.",
"teams": [
{
"html_url": "https://subdomain.pagerduty.com/teams/PQ9K7I8",
"id": "PQ9K7I8",
"self": "https://api.pagerduty.com/teams/PQ9K7I8",
"summary": "Engineering",
"type": "team_reference"
}
],
"title": "The server is on fire.",
"type": "incident",
"urgency": "high"
}
}
}
Workflow Library Example
Rollback Kubernetes Deployment and Resolve Pagerduty Incident