Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
application/vnd.api+json
Response
update: handles mixed position types correctly
Update 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.
curl --request PUT \
  --url https://api.rootly.com/v1/alert_routes/{id} \
  --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": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "position": 123,
          "fallback_rule": true,
          "destinations": [
            {
              "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "target_type": "Service",
              "target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
            }
          ],
          "condition_groups": [
            {
              "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "position": 123,
              "conditions": [
                {
                  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
                  "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": "4a0148b7-8848-440a-9060-4b85086f21af",
    "type": "alert_routes",
    "attributes": {
      "name": "Updated Alert Route Name",
      "enabled": false,
      "created_at": "2025-10-30T19:47:03.055-07:00",
      "updated_at": "2025-10-30T19:47:08.414-07:00",
      "alerts_source_ids": [
        "3bb2f7e6-13fa-4ef1-8ea0-6fe14b05404f"
      ],
      "owning_team_ids": [],
      "rules": []
    }
  }
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Show child attributes
update: handles mixed position types correctly
Show child attributes
Was this page helpful?
curl --request PUT \
  --url https://api.rootly.com/v1/alert_routes/{id} \
  --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": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "position": 123,
          "fallback_rule": true,
          "destinations": [
            {
              "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "target_type": "Service",
              "target_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
            }
          ],
          "condition_groups": [
            {
              "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "position": 123,
              "conditions": [
                {
                  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
                  "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": "4a0148b7-8848-440a-9060-4b85086f21af",
    "type": "alert_routes",
    "attributes": {
      "name": "Updated Alert Route Name",
      "enabled": false,
      "created_at": "2025-10-30T19:47:03.055-07:00",
      "updated_at": "2025-10-30T19:47:08.414-07:00",
      "alerts_source_ids": [
        "3bb2f7e6-13fa-4ef1-8ea0-6fe14b05404f"
      ],
      "owning_team_ids": [],
      "rules": []
    }
  }
}