Skip to main content
POST
Create
🔑 Requires the escalation_paths.create scope.

Authorizations

Authorization
string
header
required

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

Body

application/json
name
string
required

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

Example:

"Urgent Support"

path
object[]
required

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

Example:
kind
enum<string>

Whether this path carries its own nodes, or is built from an escalation path template.

Available options:
standalone,
templated
Example:

"templated"

param_bindings
object

For a templated path, the values to bind to the template's declared parameters, keyed by parameter name.

Example:
repeat_config
object
Example:
team_ids
string[]

IDs of the teams that own this escalation path. This will automatically sync escalation paths with the right teams in Catalog. If you have an escalation paths attribute on your Teams, this attribute is required.

Example:
template_id
string

For a templated path, the template to build it from. Required when kind is templated.

Example:

"01FCNDV6P870EA6S7TK1DSYDG0"

working_hours
object[]

The working hours for this escalation path.

Example:

Response

Created response.

escalation_path
object
required