Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
application/vnd.api+json
Response
update: handles mixed position types correctly
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.
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": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"position": 123,
"fallback_rule": true,
"destinations": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"target_type": "Service",
"target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"condition_groups": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"position": 123,
"conditions": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"property_field_condition_type": "is_one_of",
"property_field_name": "<string>",
"property_field_type": "attribute",
"property_field_value": "<string>",
"property_field_values": [
"<string>"
],
"alert_urgency_ids": [
"<string>"
],
"conditionable_type": "AlertField",
"conditionable_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
]
}
]
}
]
}
}
}'{
"data": {
"id": "97de6baf-3e02-491e-b848-507a9edb5401",
"type": "alert_routes",
"attributes": {
"name": "Updated Alert Route Name",
"enabled": false,
"created_at": "2025-11-20T01:34:26.978-08:00",
"updated_at": "2025-11-20T01:34:34.945-08:00",
"alerts_source_ids": [
"452f3334-2434-4f2a-9c41-5a0d9c249dac"
],
"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": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"position": 123,
"fallback_rule": true,
"destinations": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"target_type": "Service",
"target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"condition_groups": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"position": 123,
"conditions": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"property_field_condition_type": "is_one_of",
"property_field_name": "<string>",
"property_field_type": "attribute",
"property_field_value": "<string>",
"property_field_values": [
"<string>"
],
"alert_urgency_ids": [
"<string>"
],
"conditionable_type": "AlertField",
"conditionable_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
]
}
]
}
]
}
}
}'{
"data": {
"id": "97de6baf-3e02-491e-b848-507a9edb5401",
"type": "alert_routes",
"attributes": {
"name": "Updated Alert Route Name",
"enabled": false,
"created_at": "2025-11-20T01:34:26.978-08:00",
"updated_at": "2025-11-20T01:34:34.945-08:00",
"alerts_source_ids": [
"452f3334-2434-4f2a-9c41-5a0d9c249dac"
],
"owning_team_ids": [],
"rules": []
}
}
}