Escalations V2

Create and manage escalations.

With incident.io On-call you can create escalation paths that describe how a page should be escalated to people and schedules, and create escalations that will execute those paths.

CreatePath Escalations V2

Create an escalation path.

An escalation path is a series of steps that describe how a page should be escalated, represented as graph, supporting conditional branches based on alert priority and working intervals.

We recommend you create escalation paths in the incident.io dashboard where our path builder makes it easy to use conditions and visualise the path.

Request
Request Body schema: application/json
required
name
required
string

The name of this escalation path, for the user's reference.

required
Array of objects (EscalationPathNodePayloadV2)

The nodes that form the levels and branches of this escalation path.

Array of objects (WeekdayIntervalConfigV2)

The working hours for this escalation path.

Responses
201

Created response.

post/v2/escalation_paths
Request samples
application/json
{
  • "name": "Urgent Support",
  • "path": [
    ],
  • "working_hours": [
    ]
}
Response samples
application/json
{
  • "escalation_path": {
    }
}

DestroyPath Escalations V2

Archives an escalation path.

We recommend you create escalation paths in the incident.io dashboard where our path builder makes it easy to use conditions and visualise the path.

Request
path Parameters
id
required
string

Unique identifier for this escalation path.

Example: 01FCNDV6P870EA6S7TK1DSYDG0
Responses
204

No Content response.

delete/v2/escalation_paths/{id}
Request samples 
ShowPath Escalations V2
Show an escalation path.


We recommend you create escalation paths in the incident.io dashboard where our path
builder makes it easy to use conditions and visualise the path.


Request 
path Parameters
id
required
string
Unique identifier for this escalation path.


 
 Example:  01FCNDV6P870EA6S7TK1DSYDG0
Responses 
200
OK response.


get/v2/escalation_paths/{id}
Request samples 
Response samples 
application/json
{
  • "escalation_path": {
    }
}
UpdatePath Escalations V2
Updates an escalation path.


We recommend you create escalation paths in the incident.io dashboard where our path
builder makes it easy to use conditions and visualise the path.


Request 
path Parameters
id
required
string
Unique identifier for this escalation path.


 
 Example:  01FCNDV6P870EA6S7TK1DSYDG0
Request Body schema: application/json
required
name
required
string
The name of this escalation path, for the user's reference.


 
required
Array of objects (EscalationPathNodePayloadV2) 
The nodes that form the levels and branches of this escalation path.


 
Array of objects (WeekdayIntervalConfigV2) 
The working hours for this escalation path.


 
Responses 
200
OK response.


put/v2/escalation_paths/{id}
Request samples 
application/json
{
  • "name": "Urgent Support",
  • "path": [
    ],
  • "working_hours": [
    ]
}
Response samples 
application/json
{
  • "escalation_path": {
    }
}
➔ Next to Follow-ups V2