Update a specific alert route by id. Note: This endpoint requires access to Advanced Alert Routing. If you’re unsure whether you have access to this feature, please contact Rootly customer support.
For organizations with large numbers of routing rules, Rootly supports asynchronous rule processing to improve performance. When enabled, rule updates happen in the background.
Important: When async processing is enabled, the rules list in the API response will not be up-to-date immediately after update. You should refetch the alert route after a few minutes to get the updated rules.
If you experience slow operations when managing alert routes with many rules, contact Rootly customer support to enable asynchronous rule processing for your organization.
curl --request PUT \
--url https://api.rootly.com/v1/alert_routes/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "alert_routes",
"attributes": {
"name": "<string>",
"enabled": true,
"alerts_source_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"owning_team_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"rules": [
{
"name": "<string>",
"destinations": [
{
"target_type": "Service",
"target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"condition_groups": [
{
"conditions": [
{
"property_field_condition_type": "is_one_of",
"property_field_type": "attribute",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"property_field_name": "<string>",
"property_field_value": "<string>",
"property_field_values": [
"<string>"
],
"alert_urgency_ids": [
"<string>"
],
"conditionable_type": "AlertField",
"conditionable_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"position": 123
}
],
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"position": 123,
"fallback_rule": true
}
]
}
}
}
'{
"data": {
"id": "6da57183-43f7-4e71-97cf-bee92f6691e5",
"type": "alert_routes",
"attributes": {
"name": "Updated Alert Route Name",
"enabled": false,
"created_at": "2025-12-10T16:19:25.149-08:00",
"updated_at": "2025-12-10T16:19:31.760-08:00",
"alerts_source_ids": [
"02a88f85-0323-4e0a-88c3-b40293ae1276"
],
"owning_team_ids": [],
"rules": []
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Show child attributes
alert_routes Show child attributes
The name of the alert route
Whether the alert route is enabled
The ID of the alerts source
The ID of the owning team
Show child attributes
The name of the alert routing rule
Show child attributes
The type of the target
Service, Group, EscalationPolicy The ID of the target
The ID of the target (for updates)
Show child attributes
Show child attributes
is_one_of, is_not_one_of, contains, does_not_contain, starts_with, ends_with, matches_regex, is_empty attribute, payload, alert_field The ID of the condition (for updates)
The name of the property field
The value of the property field
The Alert Urgency IDs to check in the condition
The type of the conditionable
AlertField The ID of the conditionable
The ID of the condition group (for updates)
The position of the condition group
The ID of the alert routing rule (for updates)
The position of the alert routing rule for ordering evaluation
Whether this is a fallback rule
update: handles mixed position types correctly
Show child attributes
Unique ID of the alert route
alert_routes Show child attributes
The name of the alert route
The ID of the alerts source
Whether the alert route is enabled
The ID of the owning team
Show child attributes
The name of the alert routing rule
Show child attributes
Show child attributes
is_one_of, is_not_one_of, contains, does_not_contain, starts_with, ends_with, matches_regex, is_empty attribute, payload, alert_field The name of the property field
The value of the property field
The Alert Urgency IDs to check in the condition
The type of the conditionable
AlertField The ID of the conditionable
The position of the condition group
The position of the alert routing rule for ordering evaluation
Whether this is a fallback rule
Was this page helpful?
curl --request PUT \
--url https://api.rootly.com/v1/alert_routes/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "alert_routes",
"attributes": {
"name": "<string>",
"enabled": true,
"alerts_source_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"owning_team_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"rules": [
{
"name": "<string>",
"destinations": [
{
"target_type": "Service",
"target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"condition_groups": [
{
"conditions": [
{
"property_field_condition_type": "is_one_of",
"property_field_type": "attribute",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"property_field_name": "<string>",
"property_field_value": "<string>",
"property_field_values": [
"<string>"
],
"alert_urgency_ids": [
"<string>"
],
"conditionable_type": "AlertField",
"conditionable_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"position": 123
}
],
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"position": 123,
"fallback_rule": true
}
]
}
}
}
'{
"data": {
"id": "6da57183-43f7-4e71-97cf-bee92f6691e5",
"type": "alert_routes",
"attributes": {
"name": "Updated Alert Route Name",
"enabled": false,
"created_at": "2025-12-10T16:19:25.149-08:00",
"updated_at": "2025-12-10T16:19:31.760-08:00",
"alerts_source_ids": [
"02a88f85-0323-4e0a-88c3-b40293ae1276"
],
"owning_team_ids": [],
"rules": []
}
}
}