Cancel

Cancel an escalation.

Cancelling an escalation stops any further paging: notifications cease and the escalation will not advance to further levels or repeat. This works on escalations that are still paging (for example to silence a page when an incident is resolved before anyone acknowledges it) as well as snoozed ones. Escalations that have already resolved or expired cannot be cancelled, and cancelling an already-cancelled escalation is a no-op.

To use this API, you will need an API key with the “Create and manage escalations” permission.

POST

escalations

{id}

actions

cancel

Cancel

curl --request POST \
  --url https://api.incident.io/v2/escalations/{id}/actions/cancel \
  --header 'Authorization: Bearer <token>'

Authorizations

Authorization

string

header

required

API key from your incident.io dashboard (Settings → API keys)

Path Parameters

string

required

Unique ID of the escalation

Example:

"01G0J1EXE7AXZ2C93K61WBPYEH"

Response

200

OK response.

Show

Follow-ups

⌘I

Cancel

curl --request POST \
  --url https://api.incident.io/v2/escalations/{id}/actions/cancel \
  --header 'Authorization: Bearer <token>'