AlertRoutes

Get an alert route

Get a specific alert route by id. 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.

Optional Parameters

show_nested_ids (query parameter): When set to true, the response will include IDs for all nested resources (destinations, condition_groups, conditions). This is useful when you need to reference these nested resources for updates or deletions via PATCH requests.

Example: GET /v1/alert_routes/{id}?show_nested_ids=true

GET

alert_routes

{id}

Get an alert route

curl --request GET \
  --url https://api.rootly.com/v1/alert_routes/{id} \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "id": "958596d5-c62d-42c1-871f-4980387ba484",
    "type": "alert_routes",
    "attributes": {
      "name": "Test Alert Route-b47e",
      "enabled": true,
      "created_at": "2026-02-13T18:03:38.191-08:00",
      "updated_at": "2026-02-13T18:03:38.191-08:00",
      "alerts_source_ids": [],
      "owning_team_ids": [],
      "rules": []
    }
  }
}

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Response

alert route found

data

object

required

Show child attributes

Update an alert routeUpdate a specific alert route by id. **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.** ### Asynchronous Rule Creation For organizations with large numbers of routing rules, Rootly supports asynchronous rule processing to improve performance. When enabled, rule updates happen in the background. **Important**: When async processing is enabled, the rules list in the API response will not be up-to-date immediately after update. You should refetch the alert route after a few minutes to get the updated rules. If you experience slow operations when managing alert routes with many rules, contact Rootly customer support to enable asynchronous rule processing for your organization.

⌘I

Get an alert route

curl --request GET \
  --url https://api.rootly.com/v1/alert_routes/{id} \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "id": "958596d5-c62d-42c1-871f-4980387ba484",
    "type": "alert_routes",
    "attributes": {
      "name": "Test Alert Route-b47e",
      "enabled": true,
      "created_at": "2026-02-13T18:03:38.191-08:00",
      "updated_at": "2026-02-13T18:03:38.191-08:00",
      "alerts_source_ids": [],
      "owning_team_ids": [],
      "rules": []
    }
  }
}

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

Edge Connector Actions

Edge Connectors

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