Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/vnd.api+json
Response
unknown attribute filtered out gracefully
Creates a new alert route from provided data. 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 POST \
--url https://api.rootly.com/v1/alert_routes \
--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>",
"position": 123,
"fallback_rule": true,
"destinations": [
{
"target_type": "Service",
"target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"condition_groups": [
{
"position": 123,
"conditions": [
{
"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": "1f49d34e-8b5c-404b-9d59-d6dfe31394ab",
"type": "alert_routes",
"attributes": {
"name": "Test Alert Route 6c1b",
"enabled": true,
"created_at": "2025-11-24T17:23:51.487-08:00",
"updated_at": "2025-11-24T17:23:51.487-08:00",
"alerts_source_ids": [
"d6d0eb14-fc20-4d32-9462-8094e7cc3f74"
],
"owning_team_ids": [
"df345013-35d0-4ba4-9028-c60308790f53"
],
"rules": [
{
"id": "0c17afdf-2b6b-4852-aebb-9422256c5fa6",
"name": "Test Routing Rule",
"alerts_source_id": null,
"condition_type": "all",
"enabled": true,
"position": 1,
"destination": {
"target_type": "Group",
"target_id": "df345013-35d0-4ba4-9028-c60308790f53"
},
"created_at": "2025-11-24T17:23:51.491-08:00",
"updated_at": "2025-11-24T17:23:51.491-08:00",
"destinations": [
{
"target_type": "Group",
"target_id": "df345013-35d0-4ba4-9028-c60308790f53"
}
],
"condition_groups": [
{
"position": 1,
"conditions": [
{
"property_field_condition_type": "is_one_of",
"property_field_name": "summary",
"property_field_type": "attribute",
"property_field_value": null,
"property_field_values": [
"Error from system"
],
"conditionable_id": null,
"conditionable_type": null
}
]
}
],
"owning_teams": [],
"fallback_rule": false
}
]
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Show child attributes
unknown attribute filtered out gracefully
Show child attributes
Was this page helpful?
curl --request POST \
--url https://api.rootly.com/v1/alert_routes \
--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>",
"position": 123,
"fallback_rule": true,
"destinations": [
{
"target_type": "Service",
"target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"condition_groups": [
{
"position": 123,
"conditions": [
{
"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": "1f49d34e-8b5c-404b-9d59-d6dfe31394ab",
"type": "alert_routes",
"attributes": {
"name": "Test Alert Route 6c1b",
"enabled": true,
"created_at": "2025-11-24T17:23:51.487-08:00",
"updated_at": "2025-11-24T17:23:51.487-08:00",
"alerts_source_ids": [
"d6d0eb14-fc20-4d32-9462-8094e7cc3f74"
],
"owning_team_ids": [
"df345013-35d0-4ba4-9028-c60308790f53"
],
"rules": [
{
"id": "0c17afdf-2b6b-4852-aebb-9422256c5fa6",
"name": "Test Routing Rule",
"alerts_source_id": null,
"condition_type": "all",
"enabled": true,
"position": 1,
"destination": {
"target_type": "Group",
"target_id": "df345013-35d0-4ba4-9028-c60308790f53"
},
"created_at": "2025-11-24T17:23:51.491-08:00",
"updated_at": "2025-11-24T17:23:51.491-08:00",
"destinations": [
{
"target_type": "Group",
"target_id": "df345013-35d0-4ba4-9028-c60308790f53"
}
],
"condition_groups": [
{
"position": 1,
"conditions": [
{
"property_field_condition_type": "is_one_of",
"property_field_name": "summary",
"property_field_type": "attribute",
"property_field_value": null,
"property_field_values": [
"Error from system"
],
"conditionable_id": null,
"conditionable_type": null
}
]
}
],
"owning_teams": [],
"fallback_rule": false
}
]
}
}
}