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": "062520ca-6bdc-4831-84f1-da1050b1ed3b",
"type": "alert_routes",
"attributes": {
"name": "Test Alert Route 1177",
"enabled": true,
"created_at": "2025-10-30T05:25:48.015-07:00",
"updated_at": "2025-10-30T05:25:48.015-07:00",
"alerts_source_ids": [
"5cb1d93c-6318-4747-b237-dae0fd4b91cd"
],
"owning_team_ids": [
"4b1a0c3a-0c2e-4424-b907-9ee3fd56c7be"
],
"rules": [
{
"id": "4f1816f2-d212-4ec8-b85a-fc0c2a5bb6e7",
"name": "Test Routing Rule",
"alerts_source_id": null,
"condition_type": "all",
"enabled": true,
"position": 1,
"destination": {
"id": "7ea8bf97-c62b-4aeb-9a08-4ea77b693c14",
"target_type": "Group",
"target_id": "4b1a0c3a-0c2e-4424-b907-9ee3fd56c7be",
"created_at": "2025-10-30T05:25:48.024-07:00",
"updated_at": "2025-10-30T05:25:48.024-07:00"
},
"created_at": "2025-10-30T05:25:48.022-07:00",
"updated_at": "2025-10-30T05:25:48.022-07:00",
"destinations": [
{
"id": "7ea8bf97-c62b-4aeb-9a08-4ea77b693c14",
"target_type": "Group",
"target_id": "4b1a0c3a-0c2e-4424-b907-9ee3fd56c7be",
"created_at": "2025-10-30T05:25:48.024-07:00",
"updated_at": "2025-10-30T05:25:48.024-07:00"
}
],
"condition_groups": [
{
"id": "79be78c1-e1ce-4396-9764-45aad1f1ebf6",
"position": 1,
"created_at": "2025-10-30T05:25:48.026-07:00",
"updated_at": "2025-10-30T05:25:48.026-07:00",
"conditions": [
{
"id": "9e24f47e-e363-4f38-9b3c-e7dca6a2274e",
"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-10-30T05:25:48.030-07:00",
"updated_at": "2025-10-30T05:25:48.030-07:00"
}
]
}
],
"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": "062520ca-6bdc-4831-84f1-da1050b1ed3b",
"type": "alert_routes",
"attributes": {
"name": "Test Alert Route 1177",
"enabled": true,
"created_at": "2025-10-30T05:25:48.015-07:00",
"updated_at": "2025-10-30T05:25:48.015-07:00",
"alerts_source_ids": [
"5cb1d93c-6318-4747-b237-dae0fd4b91cd"
],
"owning_team_ids": [
"4b1a0c3a-0c2e-4424-b907-9ee3fd56c7be"
],
"rules": [
{
"id": "4f1816f2-d212-4ec8-b85a-fc0c2a5bb6e7",
"name": "Test Routing Rule",
"alerts_source_id": null,
"condition_type": "all",
"enabled": true,
"position": 1,
"destination": {
"id": "7ea8bf97-c62b-4aeb-9a08-4ea77b693c14",
"target_type": "Group",
"target_id": "4b1a0c3a-0c2e-4424-b907-9ee3fd56c7be",
"created_at": "2025-10-30T05:25:48.024-07:00",
"updated_at": "2025-10-30T05:25:48.024-07:00"
},
"created_at": "2025-10-30T05:25:48.022-07:00",
"updated_at": "2025-10-30T05:25:48.022-07:00",
"destinations": [
{
"id": "7ea8bf97-c62b-4aeb-9a08-4ea77b693c14",
"target_type": "Group",
"target_id": "4b1a0c3a-0c2e-4424-b907-9ee3fd56c7be",
"created_at": "2025-10-30T05:25:48.024-07:00",
"updated_at": "2025-10-30T05:25:48.024-07:00"
}
],
"condition_groups": [
{
"id": "79be78c1-e1ce-4396-9764-45aad1f1ebf6",
"position": 1,
"created_at": "2025-10-30T05:25:48.026-07:00",
"updated_at": "2025-10-30T05:25:48.026-07:00",
"conditions": [
{
"id": "9e24f47e-e363-4f38-9b3c-e7dca6a2274e",
"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-10-30T05:25:48.030-07:00",
"updated_at": "2025-10-30T05:25:48.030-07:00"
}
]
}
],
"owning_teams": [],
"fallback_rule": false
}
]
}
}
}