Overview
AlertEvents
AlertGroups
AlertRoutingRules
AlertUrgencies
AlertSources
Alerts
Audits
Authorizations
CatalogEntities
CatalogEntityProperties
CatalogFields
Catalogs
[DEPRECATED] CustomFieldOptions
[DEPRECATED] CustomFields
CustomForms
DashboardPanels
Dashboards
Environments
EscalationPolicies
EscalationLevelsPolicies
EscalationLevelsPath
EscalationLevels
EscalationPaths
FormFieldOptions
FormFieldPlacementConditions
FormFieldPlacements
FormFieldPositions
FormFields
FormSetConditions
FormSets
Functionalities
WorkflowTasks
[DEPRECATED] WorkflowCustomFieldSelections
WorkflowFormFieldConditions
WorkflowGroups
WorkflowRuns
Workflows
Heartbeats
IncidentActionItems
[DEPRECATED] IncidentCustomFieldSelections
IncidentEventFunctionalities
IncidentEventServices
IncidentEvents
IncidentFeedbacks
IncidentFormFieldSelections
IncidentPermissionSetBooleans
IncidentPermissionSetResources
IncidentPermissionSets
IncidentRetrospectives
IncidentRetrospectiveSteps
IncidentRoleTasks
IncidentRoles
IncidentStatusPageEvents
IncidentSubStatuses
IncidentTypes
Incidents
- GETList incidents
- POSTCreates an incident
- GETRetrieves an incident
- PUTUpdate an incident
- DELDelete an incident
- PUTMitigate an incident
- PUTResolve an incident
- PUTCancel an incident
- PUTTriage an incident
- PUTRestart an incident
- PUTMark an incident as a duplicate
- POSTAdd subscribers to incident
- DELRemove subscribers from incident
- POSTAssign user to incident
- DELRemove assigned user from incident
IpRanges
LiveCallRouters
OnCallRoles
OnCallShadows
OverrideShifts
PlaybookTasks
Playbooks
RetrospectiveTemplates
RetrospectiveConfigurations
RetrospectiveProcessGroupSteps
RetrospectiveProcessGroups
RetrospectiveProcesses
RetrospectiveSteps
ScheduleRotationActiveDays
ScheduleRotationUsers
ScheduleRotations
Schedules
Services
Severities
StatusPageTemplates
StatusPages
SubStatuses
Teams
UserNotificationRules
WebhooksDeliveries
Creates an alert routing rule
Creates a new alert routing rule from provided data
curl --request POST \
--url https://api.rootly.com/v1/alert_routing_rules \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"data": {
"type": "alert_routing_rules",
"attributes": {
"name": "<string>",
"enabled": true,
"owning_team_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"alerts_source_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"condition_type": "all",
"conditions": [
{
"property_field_type": "attribute",
"property_field_name": "<string>",
"property_field_condition_type": "is",
"property_field_value": "<string>"
}
],
"destination": {
"target_type": "Group",
"target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}
}
}'
{
"data": {
"id": "244a8088-fabe-44f1-821e-ed9f05556411",
"type": "alert_routing_rules",
"attributes": {
"name": "Test Alert Routing Rule 1",
"alerts_source_id": "f0b40ec9-d633-4517-b685-41f8b1ecdea2",
"condition_type": "all",
"enabled": false,
"created_at": "2025-03-28T22:57:44.155-07:00",
"updated_at": "2025-03-28T22:57:44.155-07:00",
"destination": {
"id": "434e756f-5c94-4cde-b566-071972851552",
"target_type": "Group",
"target_id": "94bcbc51-c992-4588-bc87-89bd1cd67761",
"created_at": "2025-03-28T22:57:44.157-07:00",
"updated_at": "2025-03-28T22:57:44.157-07:00"
},
"conditions": [
{
"id": "7fc1131a-85c7-4bdf-ae60-939850325259",
"property_field_condition_type": "is",
"property_field_name": "description",
"property_field_type": "attribute",
"property_field_value": "Open",
"created_at": "2025-03-28T22:57:44.158-07:00",
"updated_at": "2025-03-28T22:57:44.158-07:00"
}
]
},
"relationships": {
"owning_teams": {
"data": []
}
}
}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
alert_routing_rules
The name of the alert routing rule
The ID of the alerts source
Whether the alert routing rule is enabled
The IDs of the teams which own the alert routing rule. If the user don't have Alert Routing Create Permission in On Call Roles, then this field is required and can contain Team IDs the user is an admin of.
The type of condition for the alert routing rule
all
, any
The type of the property field
attribute
, payload
The name of the property field. If the property field type is selected as 'attribute', then the allowed property field names are 'summary' (for Title), 'description', 'alert_urgency' and 'external_url' (for Alert Source URL). If the property field type is selected as 'payload', then the property field name should be supplied in JSON Path syntax.
The condition type of the property field
is
, is_not
, contains
, does_not_contain
, starts_with
, ends_with
, matches_regex
, is_empty
The value of the property field
Response
Unique ID of the alert_routing_rule
alert_routing_rules
The name of the alert routing rule
Whether the alert routing rule is enabled
The ID of the alerts source
The type of condition for the alert routing rule
all
, any
Date of creation
Date of last update
The conditions for the alert routing rule
The type of the property field
attribute
, payload
The name of the property field
The condition type of the property field
is
, is_not
, contains
, does_not_contain
, starts_with
, ends_with
, matches_regex
, is_empty
The value of the property field
Was this page helpful?
curl --request POST \
--url https://api.rootly.com/v1/alert_routing_rules \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"data": {
"type": "alert_routing_rules",
"attributes": {
"name": "<string>",
"enabled": true,
"owning_team_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"alerts_source_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"condition_type": "all",
"conditions": [
{
"property_field_type": "attribute",
"property_field_name": "<string>",
"property_field_condition_type": "is",
"property_field_value": "<string>"
}
],
"destination": {
"target_type": "Group",
"target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}
}
}'
{
"data": {
"id": "244a8088-fabe-44f1-821e-ed9f05556411",
"type": "alert_routing_rules",
"attributes": {
"name": "Test Alert Routing Rule 1",
"alerts_source_id": "f0b40ec9-d633-4517-b685-41f8b1ecdea2",
"condition_type": "all",
"enabled": false,
"created_at": "2025-03-28T22:57:44.155-07:00",
"updated_at": "2025-03-28T22:57:44.155-07:00",
"destination": {
"id": "434e756f-5c94-4cde-b566-071972851552",
"target_type": "Group",
"target_id": "94bcbc51-c992-4588-bc87-89bd1cd67761",
"created_at": "2025-03-28T22:57:44.157-07:00",
"updated_at": "2025-03-28T22:57:44.157-07:00"
},
"conditions": [
{
"id": "7fc1131a-85c7-4bdf-ae60-939850325259",
"property_field_condition_type": "is",
"property_field_name": "description",
"property_field_type": "attribute",
"property_field_value": "Open",
"created_at": "2025-03-28T22:57:44.158-07:00",
"updated_at": "2025-03-28T22:57:44.158-07:00"
}
]
},
"relationships": {
"owning_teams": {
"data": []
}
}
}
}