PUT /incidents/{id}/merge

Merge a list of source incidents into the target incident.

After the merge is performed the target incident will contain the source incidents' alerts, and the source incidents will be resolved.

Only incidents that have alerts or incidents that were created manually in the UI can be merged.

Open incidents cannot be merged into a resolved incident.

An incident cannot have more than 1000 alerts. The server will return an error if merging the source incidents will result in the target incident having more than 1000 alerts.

Scoped OAuth requires: incidents.write

Servers

Path parameters

Name Type Required Description
id String Yes

The ID of the resource.

Request headers

Name Type Required Description
Accept String Yes

The Accept header is used as a versioning header.

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

Content-Type String Yes

Possible values:

  • "application/json"

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
source_incidents[] Array Yes

The source incidents that will be merged into the target incident and resolved.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. 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.
  3. Click Test request to test run your request to the API and see the API's response.