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

Preview this Workflow on desktop