Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/vnd.api+json
Response
alert route created
Creates a new alert route from provided data
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": "e1d966c6-4e5e-4343-a44a-62aea3f9f6ba",
"type": "alert_routes",
"attributes": {
"name": "Test Alert Route d60b",
"enabled": true,
"created_at": "2025-09-18T20:52:08.253-07:00",
"updated_at": "2025-09-18T20:52:08.253-07:00",
"alerts_source_ids": [
"eed23fa1-b42e-4151-9164-8c1e51e8dfa1"
],
"owning_team_ids": [
"349adac6-17ac-4f3c-a819-1d839856d9ca"
]
},
"relationships": {
"alert_routing_rules": {
"data": [
{
"id": "43e4a8a5-e48c-4459-809d-e2890e343d74",
"type": "alert_routing_rules"
}
]
}
}
},
"included": [
{
"id": "43e4a8a5-e48c-4459-809d-e2890e343d74",
"type": "alert_routing_rules",
"attributes": {
"name": "Test Routing Rule",
"alerts_source_id": null,
"condition_type": "all",
"enabled": true,
"position": 1,
"destination": {
"id": "cd37f0a6-d37d-4c3d-aca8-e70078cd32e3",
"target_type": "Group",
"target_id": "349adac6-17ac-4f3c-a819-1d839856d9ca",
"created_at": "2025-09-18T20:52:08.267-07:00",
"updated_at": "2025-09-18T20:52:08.267-07:00"
},
"created_at": "2025-09-18T20:52:08.259-07:00",
"updated_at": "2025-09-18T20:52:08.259-07:00",
"destinations": [
{
"id": "cd37f0a6-d37d-4c3d-aca8-e70078cd32e3",
"target_type": "Group",
"target_id": "349adac6-17ac-4f3c-a819-1d839856d9ca",
"created_at": "2025-09-18T20:52:08.267-07:00",
"updated_at": "2025-09-18T20:52:08.267-07:00"
}
],
"condition_groups": [
{
"id": "11bb1eb0-d7cd-498a-9a68-7a800169b104",
"position": 1,
"created_at": "2025-09-18T20:52:08.268-07:00",
"updated_at": "2025-09-18T20:52:08.268-07:00",
"conditions": [
{
"id": "4ebd1da7-bb4c-4c8b-b81f-b673085a94a8",
"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,
"created_at": "2025-09-18T20:52:08.271-07:00",
"updated_at": "2025-09-18T20:52:08.271-07:00"
}
]
}
]
},
"relationships": {
"owning_teams": {
"data": []
}
}
}
]
}
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Show child attributes
alert route created
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": "e1d966c6-4e5e-4343-a44a-62aea3f9f6ba",
"type": "alert_routes",
"attributes": {
"name": "Test Alert Route d60b",
"enabled": true,
"created_at": "2025-09-18T20:52:08.253-07:00",
"updated_at": "2025-09-18T20:52:08.253-07:00",
"alerts_source_ids": [
"eed23fa1-b42e-4151-9164-8c1e51e8dfa1"
],
"owning_team_ids": [
"349adac6-17ac-4f3c-a819-1d839856d9ca"
]
},
"relationships": {
"alert_routing_rules": {
"data": [
{
"id": "43e4a8a5-e48c-4459-809d-e2890e343d74",
"type": "alert_routing_rules"
}
]
}
}
},
"included": [
{
"id": "43e4a8a5-e48c-4459-809d-e2890e343d74",
"type": "alert_routing_rules",
"attributes": {
"name": "Test Routing Rule",
"alerts_source_id": null,
"condition_type": "all",
"enabled": true,
"position": 1,
"destination": {
"id": "cd37f0a6-d37d-4c3d-aca8-e70078cd32e3",
"target_type": "Group",
"target_id": "349adac6-17ac-4f3c-a819-1d839856d9ca",
"created_at": "2025-09-18T20:52:08.267-07:00",
"updated_at": "2025-09-18T20:52:08.267-07:00"
},
"created_at": "2025-09-18T20:52:08.259-07:00",
"updated_at": "2025-09-18T20:52:08.259-07:00",
"destinations": [
{
"id": "cd37f0a6-d37d-4c3d-aca8-e70078cd32e3",
"target_type": "Group",
"target_id": "349adac6-17ac-4f3c-a819-1d839856d9ca",
"created_at": "2025-09-18T20:52:08.267-07:00",
"updated_at": "2025-09-18T20:52:08.267-07:00"
}
],
"condition_groups": [
{
"id": "11bb1eb0-d7cd-498a-9a68-7a800169b104",
"position": 1,
"created_at": "2025-09-18T20:52:08.268-07:00",
"updated_at": "2025-09-18T20:52:08.268-07:00",
"conditions": [
{
"id": "4ebd1da7-bb4c-4c8b-b81f-b673085a94a8",
"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,
"created_at": "2025-09-18T20:52:08.271-07:00",
"updated_at": "2025-09-18T20:52:08.271-07:00"
}
]
}
]
},
"relationships": {
"owning_teams": {
"data": []
}
}
}
]
}