Creates an alert routing rule

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>", "alerts_source_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "destination": { "target_type": "Service", "target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }, "enabled": true, "owning_team_ids": [ "3c90c3cc-0d44-4b50-8888-8dd25736052a" ], "position": 123, "condition_type": "all", "conditions": [ { "property_field_type": "attribute", "property_field_name": "<string>", "property_field_condition_type": "is_one_of", "property_field_value": "<string>", "property_field_values": [ "<string>" ] } ] } } } '

{ "data": { "id": "7d10e121-b57c-4ab7-b57e-d721e4524de3", "type": "alert_routing_rules", "attributes": { "name": "Test Alert Routing Rule 1", "alerts_source_id": "4f357127-1873-4785-94d6-a00ea7e23943", "condition_type": "all", "enabled": false, "position": 2, "destination": { "target_type": "Group", "target_id": "351c2006-3d10-4aea-8da5-99d36991831d" }, "created_at": "2025-12-11T17:09:22.777-08:00", "updated_at": "2025-12-11T17:09:22.777-08:00", "destinations": [ { "target_type": "Group", "target_id": "351c2006-3d10-4aea-8da5-99d36991831d" } ], "conditions": [ { "property_field_condition_type": "is_one_of", "property_field_name": "description", "property_field_type": "attribute", "property_field_value": null, "property_field_values": [ "Open" ], "conditionable_id": null, "conditionable_type": null } ] }, "relationships": { "owning_teams": { "data": [ { "id": "351c2006-3d10-4aea-8da5-99d36991831d", "type": "groups" } ] } } } }

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/vnd.api+json

data

object

required

Show child attributes

data.type

enum<string>

required

Available options:

alert_routing_rules

data.attributes

object

required

Show child attributes

data.attributes.name

string

required

The name of the alert routing rule

data.attributes.alerts_source_id

string<uuid>

required

The ID of the alerts source

data.attributes.destination

object

required

Show child attributes

data.attributes.destination.target_type

enum<string>

required

The type of the target

Available options:

Service,

Group,

EscalationPolicy

data.attributes.destination.target_id

string<uuid>

required

The ID of the target

data.attributes.enabled

boolean

Whether the alert routing rule is enabled

data.attributes.owning_team_ids

string<uuid>[]

The IDs of the teams which own the alert routing rule. If the user doesn'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.

data.attributes.position

integer

The position of the alert routing rule for ordering evaluation

data.attributes.condition_type

enum<string>

The type of condition for the alert routing rule

Available options:

all,

any

data.attributes.conditions

object[]

Show child attributes

data.attributes.conditions.property_field_type

enum<string>

required

The type of the property field

Available options:

attribute,

payload

data.attributes.conditions.property_field_name

string

required

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.

data.attributes.conditions.property_field_condition_type

enum<string>

required

The condition type of the property field

Available options:

is_one_of,

is_not_one_of,

contains,

does_not_contain,

starts_with,

ends_with,

matches_regex,

is_empty

data.attributes.conditions.property_field_value

string

The value of the property field. Can be null if the property field condition type is 'is_one_of' or 'is_not_one_of'

data.attributes.conditions.property_field_values

string[]

The values of the property field. Need to be passed if the property field condition type is 'is_one_of' or 'is_not_one_of' except for when property field name is 'alert_urgency'

Response

alert routing rule created

data

object

required

Show child attributes

data.id

string

required

Unique ID of the alert_routing_rule

data.type

enum<string>

required

Available options:

alert_routing_rules

data.attributes

object

required

Show child attributes

data.attributes.name

string

required

The name of the alert routing rule

data.attributes.enabled

boolean

required

Whether the alert routing rule is enabled

data.attributes.alerts_source_id

string<uuid>

required

The ID of the alerts source

data.attributes.position

integer

required

The position of the alert routing rule for ordering evaluation

data.attributes.condition_type

enum<string>

required

The type of condition for the alert routing rule

Available options:

all,

any

data.attributes.created_at

string

required

Date of creation

data.attributes.updated_at

string

required

Date of last update

data.attributes.conditions

object[]

The conditions for the alert routing rule

Show child attributes

data.attributes.conditions.property_field_type

enum<string>

required

The type of the property field

Available options:

attribute,

payload

data.attributes.conditions.property_field_name

string

required

data.attributes.conditions.property_field_condition_type

enum<string>

required

The condition type of the property field

Available options:

is_one_of,

is_not_one_of,

contains,

does_not_contain,

starts_with,

ends_with,

matches_regex,

is_empty

data.attributes.conditions.property_field_value

string | null

The value of the property field. Can be null if the property field condition type is 'is_one_of' or 'is_not_one_of'

data.attributes.conditions.property_field_values

string[]

The values of the property field. Used if the property field condition type is 'is_one_of' or 'is_not_one_of' except for when property field name is 'alert_urgency'

data.attributes.destination

object

The destinations for the alert routing rule

Show child attributes

data.attributes.destination.target_type

enum<string>

required

The type of the target

Available options:

Service,

Group,

EscalationPolicy

data.attributes.destination.target_id

string<uuid>

required

The ID of the target

data.attributes.condition_groups

object[]

The condition groups for the alert routing rule

Show child attributes

data.attributes.condition_groups.position

integer

required

The position of the condition group for ordering

data.attributes.condition_groups.id

string<uuid>

Unique ID of the condition group

data.attributes.condition_groups.conditions

object[]

The conditions within this group

Show child attributes

data.attributes.condition_groups.conditions.property_field_type

enum<string>

required

The type of the property field

Available options:

attribute,

payload

data.attributes.condition_groups.conditions.property_field_name

string

required

The name of the property field

data.attributes.condition_groups.conditions.property_field_condition_type

enum<string>

required

The condition type of the property field

Available options:

is_one_of,

is_not_one_of,

contains,

does_not_contain,

starts_with,

ends_with,

matches_regex,

is_empty

data.attributes.condition_groups.conditions.id

string<uuid>

Unique ID of the condition

data.attributes.condition_groups.conditions.property_field_value

string | null

The value of the property field

data.attributes.condition_groups.conditions.property_field_values

string[] | null

The values of the property field

data.attributes.condition_groups.conditions.conditionable_id

string<uuid> | null

The ID of the conditionable object

data.attributes.condition_groups.conditions.conditionable_type

string | null

The type of the conditionable object

data.attributes.condition_groups.conditions.created_at

string

Date of creation

data.attributes.condition_groups.conditions.updated_at

string

Date of last update

data.attributes.condition_groups.created_at

string

Date of creation

data.attributes.condition_groups.updated_at

string

Date of last update

Overview

AlertEvents

AlertFields

AlertGroups

AlertRoutes

AlertRoutingRules

AlertUrgencies

AlertSources

Alerts

Audits

Authorizations

CatalogEntities

CatalogEntityProperties

CatalogFields

Catalogs

Causes

Communications Groups

Communications Stages

Communications Templates

Communications Types

[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

IpRanges

LiveCallRouters

OnCallRoles

OnCallShadows

OverrideShifts

PlaybookTasks

Playbooks

RetrospectiveTemplates

Pulses

RetrospectiveConfigurations

RetrospectiveProcessGroupSteps

RetrospectiveProcessGroups

RetrospectiveProcesses

RetrospectiveSteps

Roles

ScheduleRotationActiveDays