Alert Routes V2

Configure your alert routes in incident.io.

Alert routes define how alerts from different sources are processed, grouped, and routed to the right teams and people.

List Alert Routes V2

List all alert routes in your account.

Request

query Parameters

page_size required	integer <int64> [ 1 .. 50 ] Default: 25 Number of alert routes to return per page Example: page_size=25
after	string The ID of the last alert route on the previous page Examples: default after=01FCNDV6P870EA6S7TK1DSYDG0

Responses

200

OK response.

get/v2/alert_routes

Request samples

curl

Response samples

application/json

{"alert_routes": [{"enabled": false,
"id": "01FCNDV6P870EA6S7TK1DSYDG0",
"name": "Production incidents"
}
],
"pagination_meta": {"after": "01FCNDV6P870EA6S7TK1DSYDG0",
"page_size": 25
}
}

Create Alert Routes V2

Create a new alert route in your account.

Request

Request Body schema: application/json
required

required	Array of objects (AlertRouteAlertSourcePayloadV2) Which alert sources should this alert route match?
required	Array of objects (AlertRouteChannelConfigPayloadV2) The channel configuration for this alert route
required	Array of objects (ConditionGroupPayloadV2) What condition groups must be true for this alert route to fire?
created_at	string <date-time> The time of creation of this alert route
enabled required	boolean Whether this alert route is enabled or not
required	object (AlertRouteEscalationConfigPayloadV2)
required	Array of objects (ExpressionPayloadV2) The expressions used in this template
required	object (AlertRouteIncidentConfigPayloadV2)
required	object (AlertRouteIncidentTemplatePayloadV2)
is_private required	boolean Whether this alert route is private. Private alert routes will only create private incidents from alerts.
name required	string The name of this alert route config, for the user's reference
updated_at	string <date-time> The time of last update of this alert route
version required	integer <int64> The version of this alert route config

Responses

201

Created response.

post/v2/alert_routes

Request samples

Payload
curl

application/json

{"alert_sources": [{"alert_source_id": "01FCNDV6P870EA6S7TK1DSYDG0",
"condition_groups": [{"conditions": [{"operation": "one_of",
"param_bindings": [{"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": "incident.severity"
}
]
}
]
}
],
"channel_config": [{"condition_groups": [{"conditions": [{"operation": "one_of",
"param_bindings": [{"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": "incident.severity"
}
]
}
],
"ms_teams_targets": {"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
},
"channel_visibility": "abc123"
},
"slack_targets": {"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
},
"channel_visibility": "abc123"
}
}
],
"condition_groups": [{"conditions": [{"operation": "one_of",
"param_bindings": [{"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": "incident.severity"
}
]
}
],
"created_at": "2021-08-17T13:28:57.801578Z",
"enabled": false,
"escalation_config": {"auto_cancel_escalations": false,
"escalation_targets": [{"escalation_paths": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
},
"users": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
}
]
},
"expressions": [{"else_branch": {"result": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"label": "Team Slack channel",
"operations": [{"branches": {"branches": [{"condition_groups": [{"conditions": [{"operation": "one_of",
"param_bindings": [{"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": "incident.severity"
}
]
}
],
"result": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
}
],
"returns": {"array": true,
"type": "IncidentStatus"
}
},
"filter": {"condition_groups": [{"conditions": [{"operation": "one_of",
"param_bindings": [{"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": "incident.severity"
}
]
}
]
},
"navigate": {"reference": "catalog_attribute[\"01FCNDV6P870EA6S7TK1DSYD5H\"]"
},
"operation_type": "navigate",
"parse": {"returns": {"array": true,
"type": "IncidentStatus"
},
"source": "metadata.annotations[\"github.com/repo\"]"
}
}
],
"reference": "abc123",
"root_reference": "incident.status"
}
],
"incident_config": {"auto_decline_enabled": false,
"condition_groups": [{"conditions": [{"operation": "one_of",
"param_bindings": [{"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": "incident.severity"
}
]
}
],
"defer_time_seconds": 1,
"enabled": false,
"grouping_keys": [{"reference": "alert.title"
}
],
"grouping_window_seconds": 1
},
"incident_template": {"custom_fields": [{"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
},
"custom_field_id": "01FCNDV6P870EA6S7TK1DSYDG0",
"merge_strategy": "append"
}
],
"incident_mode": {"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"incident_type": {"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"name": {"autogenerated": false,
"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"severity": {"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
},
"merge_strategy": "append"
},
"start_in_triage": {"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"summary": {"autogenerated": false,
"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"workspace": {"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
}
},
"is_private": false,
"name": "Production incidents",
"updated_at": "2021-08-17T13:28:57.801578Z",
"version": 1
}

Response samples

application/json

{"alert_route": {"alert_sources": [{"alert_source_id": "01FCNDV6P870EA6S7TK1DSYDG0",
"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
]
}
],
"channel_config": [{"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
],
"ms_teams_targets": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
},
"channel_visibility": "abc123"
},
"slack_targets": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
},
"channel_visibility": "abc123"
}
}
],
"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
],
"created_at": "2021-08-17T13:28:57.801578Z",
"enabled": false,
"escalation_config": {"auto_cancel_escalations": false,
"escalation_targets": [{"escalation_paths": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
},
"users": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
]
},
"expressions": [{"else_branch": {"result": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"label": "Team Slack channel",
"operations": [{"branches": {"branches": [{"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
],
"result": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
],
"returns": {"array": true,
"type": "IncidentStatus"
}
},
"filter": {"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
]
},
"navigate": {"reference": "1235",
"reference_label": "Teams"
},
"operation_type": "navigate",
"parse": {"returns": {"array": true,
"type": "IncidentStatus"
},
"source": "metadata.annotations[\"github.com/repo\"]"
},
"returns": {"array": true,
"type": "IncidentStatus"
}
}
],
"reference": "abc123",
"returns": {"array": true,
"type": "IncidentStatus"
},
"root_reference": "incident.status"
}
],
"id": "01FCNDV6P870EA6S7TK1DSYDG0",
"incident_config": {"auto_decline_enabled": false,
"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
],
"defer_time_seconds": 1,
"enabled": false,
"grouping_keys": [{"reference": "alert.title"
}
],
"grouping_window_seconds": 1
},
"incident_template": {"custom_fields": [{"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
},
"custom_field_id": "01FCNDV6P870EA6S7TK1DSYDG0",
"merge_strategy": "append"
}
],
"incident_mode": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"incident_type": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"name": {"autogenerated": false,
"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"severity": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
},
"merge_strategy": "append"
},
"start_in_triage": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"summary": {"autogenerated": false,
"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"workspace": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
},
"is_private": false,
"name": "Production incidents",
"updated_at": "2021-08-17T13:28:57.801578Z",
"version": 1
}
}

Delete Alert Routes V2

Delete an existing alert route in your account.

Request

path Parameters

required

string

Unique identifier of the alert route

Example: 01FCNDV6P870EA6S7TK1DSYDG0

Responses

204

No Content response.

delete/v2/alert_routes/{id}

Request samples

curl

Show Alert Routes V2

Load details about a specific alert route in your account.

Request

path Parameters

required

string

Unique identifier of the alert route

Example: 01FCNDV6P870EA6S7TK1DSYDG0

Responses

200

OK response.

get/v2/alert_routes/{id}

Request samples

curl

Response samples

application/json

{"alert_route": {"alert_sources": [{"alert_source_id": "01FCNDV6P870EA6S7TK1DSYDG0",
"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
]
}
],
"channel_config": [{"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
],
"ms_teams_targets": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
},
"channel_visibility": "abc123"
},
"slack_targets": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
},
"channel_visibility": "abc123"
}
}
],
"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
],
"created_at": "2021-08-17T13:28:57.801578Z",
"enabled": false,
"escalation_config": {"auto_cancel_escalations": false,
"escalation_targets": [{"escalation_paths": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
},
"users": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
]
},
"expressions": [{"else_branch": {"result": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"label": "Team Slack channel",
"operations": [{"branches": {"branches": [{"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
],
"result": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
],
"returns": {"array": true,
"type": "IncidentStatus"
}
},
"filter": {"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
]
},
"navigate": {"reference": "1235",
"reference_label": "Teams"
},
"operation_type": "navigate",
"parse": {"returns": {"array": true,
"type": "IncidentStatus"
},
"source": "metadata.annotations[\"github.com/repo\"]"
},
"returns": {"array": true,
"type": "IncidentStatus"
}
}
],
"reference": "abc123",
"returns": {"array": true,
"type": "IncidentStatus"
},
"root_reference": "incident.status"
}
],
"id": "01FCNDV6P870EA6S7TK1DSYDG0",
"incident_config": {"auto_decline_enabled": false,
"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
],
"defer_time_seconds": 1,
"enabled": false,
"grouping_keys": [{"reference": "alert.title"
}
],
"grouping_window_seconds": 1
},
"incident_template": {"custom_fields": [{"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
},
"custom_field_id": "01FCNDV6P870EA6S7TK1DSYDG0",
"merge_strategy": "append"
}
],
"incident_mode": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"incident_type": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"name": {"autogenerated": false,
"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"severity": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
},
"merge_strategy": "append"
},
"start_in_triage": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"summary": {"autogenerated": false,
"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"workspace": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
},
"is_private": false,
"name": "Production incidents",
"updated_at": "2021-08-17T13:28:57.801578Z",
"version": 1
}
}

Update Alert Routes V2

Update an existing alert route in your account.

Request

path Parameters

required

string

Unique identifier of the alert route

Examples:

default 01FCNDV6P870EA6S7TK1DSYDG0

Request Body schema: application/json
required

required	Array of objects (AlertRouteAlertSourcePayloadV2) Which alert sources should this alert route match?
required	Array of objects (AlertRouteChannelConfigPayloadV2) The channel configuration for this alert route
required	Array of objects (ConditionGroupPayloadV2) What condition groups must be true for this alert route to fire?
created_at	string <date-time> The time of creation of this alert route
enabled required	boolean Whether this alert route is enabled or not
required	object (AlertRouteEscalationConfigPayloadV2)
required	Array of objects (ExpressionPayloadV2) The expressions used in this template
required	object (AlertRouteIncidentConfigPayloadV2)
required	object (AlertRouteIncidentTemplatePayloadV2)
is_private required	boolean Whether this alert route is private. Private alert routes will only create private incidents from alerts.
name required	string The name of this alert route config, for the user's reference
updated_at	string <date-time> The time of last update of this alert route
version required	integer <int64> The version of this alert route config

Responses

200

OK response.

put/v2/alert_routes/{id}

Request samples

Payload
curl

application/json

{"alert_sources": [{"alert_source_id": "01FCNDV6P870EA6S7TK1DSYDG0",
"condition_groups": [{"conditions": [{"operation": "one_of",
"param_bindings": [{"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": "incident.severity"
}
]
}
]
}
],
"channel_config": [{"condition_groups": [{"conditions": [{"operation": "one_of",
"param_bindings": [{"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": "incident.severity"
}
]
}
],
"ms_teams_targets": {"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
},
"channel_visibility": "abc123"
},
"slack_targets": {"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
},
"channel_visibility": "abc123"
}
}
],
"condition_groups": [{"conditions": [{"operation": "one_of",
"param_bindings": [{"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": "incident.severity"
}
]
}
],
"created_at": "2021-08-17T13:28:57.801578Z",
"enabled": false,
"escalation_config": {"auto_cancel_escalations": false,
"escalation_targets": [{"escalation_paths": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
},
"users": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
}
]
},
"expressions": [{"else_branch": {"result": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"label": "Team Slack channel",
"operations": [{"branches": {"branches": [{"condition_groups": [{"conditions": [{"operation": "one_of",
"param_bindings": [{"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": "incident.severity"
}
]
}
],
"result": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
}
],
"returns": {"array": true,
"type": "IncidentStatus"
}
},
"filter": {"condition_groups": [{"conditions": [{"operation": "one_of",
"param_bindings": [{"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": "incident.severity"
}
]
}
]
},
"navigate": {"reference": "catalog_attribute[\"01FCNDV6P870EA6S7TK1DSYD5H\"]"
},
"operation_type": "navigate",
"parse": {"returns": {"array": true,
"type": "IncidentStatus"
},
"source": "metadata.annotations[\"github.com/repo\"]"
}
}
],
"reference": "abc123",
"root_reference": "incident.status"
}
],
"incident_config": {"auto_decline_enabled": false,
"condition_groups": [{"conditions": [{"operation": "one_of",
"param_bindings": [{"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": "incident.severity"
}
]
}
],
"defer_time_seconds": 1,
"enabled": false,
"grouping_keys": [{"reference": "alert.title"
}
],
"grouping_window_seconds": 1
},
"incident_template": {"custom_fields": [{"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
},
"custom_field_id": "01FCNDV6P870EA6S7TK1DSYDG0",
"merge_strategy": "append"
}
],
"incident_mode": {"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"incident_type": {"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"name": {"autogenerated": false,
"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"severity": {"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
},
"merge_strategy": "append"
},
"start_in_triage": {"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"summary": {"autogenerated": false,
"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"workspace": {"binding": {"array_value": [{"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"literal": "SEV123",
"reference": "incident.severity"
}
}
}
},
"is_private": false,
"name": "Production incidents",
"updated_at": "2021-08-17T13:28:57.801578Z",
"version": 1
}

Response samples

application/json

{"alert_route": {"alert_sources": [{"alert_source_id": "01FCNDV6P870EA6S7TK1DSYDG0",
"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
]
}
],
"channel_config": [{"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
],
"ms_teams_targets": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
},
"channel_visibility": "abc123"
},
"slack_targets": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
},
"channel_visibility": "abc123"
}
}
],
"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
],
"created_at": "2021-08-17T13:28:57.801578Z",
"enabled": false,
"escalation_config": {"auto_cancel_escalations": false,
"escalation_targets": [{"escalation_paths": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
},
"users": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
]
},
"expressions": [{"else_branch": {"result": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"label": "Team Slack channel",
"operations": [{"branches": {"branches": [{"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
],
"result": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
],
"returns": {"array": true,
"type": "IncidentStatus"
}
},
"filter": {"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
]
},
"navigate": {"reference": "1235",
"reference_label": "Teams"
},
"operation_type": "navigate",
"parse": {"returns": {"array": true,
"type": "IncidentStatus"
},
"source": "metadata.annotations[\"github.com/repo\"]"
},
"returns": {"array": true,
"type": "IncidentStatus"
}
}
],
"reference": "abc123",
"returns": {"array": true,
"type": "IncidentStatus"
},
"root_reference": "incident.status"
}
],
"id": "01FCNDV6P870EA6S7TK1DSYDG0",
"incident_config": {"auto_decline_enabled": false,
"condition_groups": [{"conditions": [{"operation": {"label": "Lawrence Jones",
"value": "01FCQSP07Z74QMMYPDDGQB9FTG"
},
"param_bindings": [{"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
],
"subject": {"label": "Incident Severity",
"reference": "incident.severity"
}
}
]
}
],
"defer_time_seconds": 1,
"enabled": false,
"grouping_keys": [{"reference": "alert.title"
}
],
"grouping_window_seconds": 1
},
"incident_template": {"custom_fields": [{"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
},
"custom_field_id": "01FCNDV6P870EA6S7TK1DSYDG0",
"merge_strategy": "append"
}
],
"incident_mode": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"incident_type": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"name": {"autogenerated": false,
"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"severity": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
},
"merge_strategy": "append"
},
"start_in_triage": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"summary": {"autogenerated": false,
"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
},
"workspace": {"binding": {"array_value": [{"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
],
"value": {"label": "Lawrence Jones",
"literal": "SEV123",
"reference": "incident.severity"
}
}
}
},
"is_private": false,
"name": "Production incidents",
"updated_at": "2021-08-17T13:28:57.801578Z",
"version": 1
}
}

➔ Next to Alert Sources V2

Alert Routes V2

List Alert Routes V2

query Parameters

Create Alert Routes V2

Request Body schema: application/jsonrequired

Delete Alert Routes V2

path Parameters

Show Alert Routes V2

path Parameters

Update Alert Routes V2

path Parameters

Request Body schema: application/jsonrequired

Request Body schema: application/json
required

Request Body schema: application/json
required