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": "76ffe04d-f9c3-469a-9b79-66b6e4467af1",
"type": "alert_routes",
"attributes": {
"name": "Updated Alert Route Name",
"enabled": false,
"created_at": "2025-12-24T09:22:34.474-08:00",
"updated_at": "2025-12-24T09:22:37.537-08:00",
"alerts_source_ids": [
"daaba0cd-6344-418e-b56d-ef2fab099d51"
],
"owning_team_ids": [],
"rules": []
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Show child attributes
update: handles mixed position types correctly
Show child attributes
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": "76ffe04d-f9c3-469a-9b79-66b6e4467af1",
"type": "alert_routes",
"attributes": {
"name": "Updated Alert Route Name",
"enabled": false,
"created_at": "2025-12-24T09:22:34.474-08:00",
"updated_at": "2025-12-24T09:22:37.537-08:00",
"alerts_source_ids": [
"daaba0cd-6344-418e-b56d-ef2fab099d51"
],
"owning_team_ids": [],
"rules": []
}
}
}