Skip to main content
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.

​
Parameters

ParameterDescription
Assign toJSON array of PagerDuty user objects to assign this incident to. e.g. 
[{“assignee”:{“id”: “USER_ID”, “type”: “user_reference”}}]
Existing Incident TypeThe incident type.
Incident Escalation LevelEscalate the incident to this level in the escalation policy.
Incident IDThe ID of the resource.
Incident ResolutionThe resolution for this incident if status is set to resolved.
Incident StatusThe new status of the incident.
Incident TitleThe new title of the incident.
Incident UrgencyThe urgency of the incident.
Updated byThe email address of a valid user associated with the account who is updating the incident.

​
Example Output

{
	"incident": {
		"id": "PT4KHLK",
		"type": "incident",
		"summary": "[#1234] The server is on fire.",
		"self": "https://api.pagerduty.com/incidents/PT4KHLK",
		"html_url": "https://subdomain.pagerduty.com/incidents/PT4KHLK",
		"incident_number": 1234,
		"created_at": "2015-10-06T21:30:42Z",
		"updated_at": "2015-10-06T21:40:23Z",
		"status": "resolved",
		"title": "The server is on fire.",
		"pending_actions": [
			{
				"type": "unacknowledge",
				"at": "2015-11-10T01:02:52Z"
			},
			{
				"type": "resolve",
				"at": "2015-11-10T04:31:52Z"
			}
		],
		"incident_key": "baf7cf21b1da41b4b0221008339ff357",
		"service": {
			"id": "PIJ90N7",
			"type": "service_reference",
			"summary": "My Mail Service",
			"self": "https://api.pagerduty.com/services/PIJ90N7",
			"html_url": "https://subdomain.pagerduty.com/service-directory/PIJ90N7"
		},
		"priority": {
			"id": "P53ZZH5",
			"type": "priority_reference",
			"summary": "P2",
			"self": "https://api.pagerduty.com/priorities/P53ZZH5"
		},
		"assigned_via": "escalation_policy",
		"assignments": [
			{
				"at": "2015-11-10T00:31:52Z",
				"assignee": {
					"id": "PXPGF42",
					"type": "user_reference",
					"summary": "Earline Greenholt",
					"self": "https://api.pagerduty.com/users/PXPGF42",
					"html_url": "https://subdomain.pagerduty.com/users/PXPGF42"
				}
			}
		],
		"acknowledgements": [
			{
				"at": "2015-11-10T00:32:52Z",
				"acknowledger": {
					"id": "PXPGF42",
					"type": "user_reference",
					"summary": "Earline Greenholt",
					"self": "https://api.pagerduty.com/users/PXPGF42",
					"html_url": "https://subdomain.pagerduty.com/users/PXPGF42"
				}
			}
		],
		"resolved_at": "2015-10-06T21:38:23Z",
		"last_status_change_at": "2015-10-06T21:38:23Z",
		"last_status_change_by": {
			"id": "PXPGF42",
			"type": "user_reference",
			"summary": "Earline Greenholt",
			"self": "https://api.pagerduty.com/users/PXPGF42",
			"html_url": "https://subdomain.pagerduty.com/users/PXPGF42"
		},
		"first_trigger_log_entry": {
			"id": "Q02JTSNZWHSEKV",
			"type": "trigger_log_entry_reference",
			"summary": "Triggered through the API",
			"self": "https://api.pagerduty.com/log_entries/Q02JTSNZWHSEKV?incident_id=PT4KHLK",
			"html_url": "https://subdomain.pagerduty.com/incidents/PT4KHLK/log_entries/Q02JTSNZWHSEKV"
		},
		"incident_type": {
			"name": "major_incident"
		},
		"escalation_policy": {
			"id": "PT20YPA",
			"type": "escalation_policy_reference",
			"summary": "Another Escalation Policy",
			"self": "https://api.pagerduty.com/escalation_policies/PT20YPA",
			"html_url": "https://subdomain.pagerduty.com/escalation_policies/PT20YPA"
		},
		"teams": [
			{
				"id": "PQ9K7I8",
				"type": "team_reference",
				"summary": "Engineering",
				"self": "https://api.pagerduty.com/teams/PQ9K7I8",
				"html_url": "https://subdomain.pagerduty.com/teams/PQ9K7I8"
			}
		],
		"urgency": "high"
	}
}

​
Workflow Library Example

Rollback Kubernetes Deployment and Resolve Pagerduty Incident
Workflow LibraryPreview this Workflow on desktop