PATCH
/
v1
/
alerts
/
{id}
curl --request PATCH \
  --url https://api.rootly.com/v1/alerts/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '{
  "data": {
    "type": "alerts",
    "attributes": {
      "noise": "noise",
      "source": "rootly",
      "summary": "<string>",
      "description": "<string>",
      "service_ids": [
        "<string>"
      ],
      "group_ids": [
        "<string>"
      ],
      "environment_ids": [
        "<string>"
      ],
      "started_at": "2023-11-07T05:31:56Z",
      "ended_at": "2023-11-07T05:31:56Z",
      "external_id": "<string>",
      "external_url": "<string>",
      "alert_urgency_id": "<string>",
      "labels": [
        {
          "key": "<string>",
          "value": "<string>"
        }
      ],
      "data": {}
    }
  }
}'
{
  "data": {
    "id": "fd65b9c1-496a-42b9-952f-8b6101dddb19",
    "type": "alerts",
    "attributes": {
      "short_id": "eshkb5",
      "source": "pagerduty",
      "status": "open",
      "summary": "test update",
      "description": "test update",
      "labels": [
        {
          "key": "foo",
          "value": "bar"
        },
        {
          "key": "bar",
          "value": "baz"
        }
      ],
      "services": [
        {
          "id": "2024dfad-99f8-4817-9fac-5e66dd1cc611",
          "team_id": 23,
          "name": "Neque recusandae officiis harum.",
          "slug": "neque-recusandae-officiis-harum",
          "description": "Repudiandae omnis rerum ab.",
          "deleted_at": null,
          "created_at": "2025-03-31T05:59:40.472-07:00",
          "updated_at": "2025-03-31T05:59:40.472-07:00",
          "opsgenie_id": null,
          "pagerduty_id": null,
          "public_description": null,
          "github_repository_branch": "master",
          "github_repository_name": null,
          "color": "#FAEBB7",
          "heroku_app_name": null,
          "gitlab_repository_name": null,
          "gitlab_repository_branch": "master",
          "kubernetes_deployment_name": null,
          "incidents_count": 0,
          "position": 1,
          "slack_channels": [],
          "slack_aliases": [],
          "backstage_id": null,
          "show_uptime": true,
          "show_uptime_last_days": 60,
          "status": "operational",
          "external_id": null,
          "notify_emails": [],
          "cortex_id": null,
          "alerts_email_enabled": false,
          "alerts_email_address": "service-104c4c2435693483895ec459fb65ee97@email.rootly.com",
          "opsgenie_team_id": null,
          "service_now_ci_sys_id": null,
          "alert_urgency_id": null,
          "opslevel_id": null
        }
      ],
      "service_ids": [
        "2024dfad-99f8-4817-9fac-5e66dd1cc611"
      ],
      "groups": [
        {
          "id": "07a6df24-ab29-4931-9516-9653e0896fb9",
          "name": "Placeat velit in eius.",
          "slug": "placeat-velit-in-eius",
          "team_id": 23,
          "deleted_at": null,
          "created_at": "2025-03-31T05:59:40.484-07:00",
          "updated_at": "2025-03-31T05:59:40.484-07:00",
          "description": null,
          "opsgenie_id": null,
          "users_count": 0,
          "incidents_count": 0,
          "pagerduty_id": null,
          "color": "#D7F5E1",
          "victor_ops_id": null,
          "position": 1,
          "slack_channels": [],
          "slack_aliases": [],
          "pagertree_id": null,
          "external_id": null,
          "notify_emails": [],
          "cortex_id": null,
          "backstage_id": null,
          "alerts_email_enabled": false,
          "alerts_email_address": "group-02cda3be30d1a5460c38ac3ecf4f8450@email.rootly.com",
          "pagerduty_service_id": null,
          "service_now_ci_sys_id": null,
          "alert_urgency_id": null,
          "opslevel_id": null,
          "admins_count": 0
        }
      ],
      "group_ids": [
        "07a6df24-ab29-4931-9516-9653e0896fb9"
      ],
      "environments": [
        {
          "id": "0bdb9536-187c-4b0a-9d9e-440c942b561b",
          "team_id": 23,
          "name": "Excepturi animi et omnis.",
          "slug": "excepturi-animi-et-omnis",
          "description": "Perspiciatis libero facere aperiam.",
          "color": "#921616",
          "deleted_at": null,
          "created_at": "2025-03-31T05:59:40.499-07:00",
          "updated_at": "2025-03-31T05:59:40.499-07:00",
          "incidents_count": 0,
          "position": 1,
          "slack_channels": [],
          "slack_aliases": [],
          "external_id": null,
          "notify_emails": []
        }
      ],
      "environment_ids": [
        "0bdb9536-187c-4b0a-9d9e-440c942b561b"
      ],
      "responders": [],
      "incidents": [
        {
          "id": "39f68fd9-c1f9-42eb-a19c-0919aae1df2f",
          "user_id": 33,
          "team_id": 23,
          "title": "Molestiae aut modi nobis.",
          "slug": "molestiae-aut-modi-nobis",
          "summary": "Similique et nihil. Sed omnis aperiam. Culpa id eveniet.",
          "status": "started",
          "slack_channel_id": null,
          "started_at": "2025-03-31T05:59:35.123-07:00",
          "mitigated_at": null,
          "resolved_at": null,
          "deleted_at": null,
          "created_at": "2025-03-31T05:59:35.123-07:00",
          "updated_at": "2025-03-31T05:59:35.123-07:00",
          "severity_id": "c8cbe2a1-26bd-4695-b198-2893de4ffc7a",
          "public_title": null,
          "zoom_meeting_id": null,
          "zoom_meeting_start_url": null,
          "zoom_meeting_join_url": null,
          "shortcut_story_id": null,
          "shortcut_story_url": null,
          "asana_task_id": null,
          "asana_task_url": null,
          "jira_issue_id": null,
          "jira_issue_url": null,
          "email_message_id": null,
          "google_meeting_id": null,
          "google_meeting_url": null,
          "trello_card_id": null,
          "trello_card_url": null,
          "linear_issue_id": null,
          "linear_issue_url": null,
          "zendesk_ticket_id": null,
          "zendesk_ticket_url": null,
          "slack_channel_name": null,
          "service_now_incident_id": null,
          "service_now_incident_url": null,
          "opsgenie_incident_id": null,
          "opsgenie_incident_url": null,
          "opsgenie_incident_responder_ids": [],
          "labels": {},
          "incidents_action_items_count": 0,
          "incidents_tasks_count": 0,
          "mitigation_message": null,
          "resolution_message": null,
          "pagerduty_incident_responder_ids": {},
          "victor_ops_incident_id": null,
          "victor_ops_incident_url": null,
          "victor_ops_incident_responder_ids": {},
          "pagerduty_incident_id": null,
          "pagerduty_incident_url": null,
          "status_pages_count": 0,
          "mattermost_channel_id": null,
          "slack_summary_timestamp": null,
          "mattermost_channel_name": null,
          "mattermost_channel_url": null,
          "slack_channel_url": null,
          "mattermost_summary_timestamp": null,
          "confluence_page_id": null,
          "confluence_page_url": null,
          "kind": "normal",
          "scheduled_for": null,
          "scheduled_until": null,
          "scheduled_remind_prior": false,
          "scheduled_auto_in_progress": true,
          "scheduled_auto_completed": true,
          "detected_at": null,
          "acknowledged_at": null,
          "private": false,
          "airtable_record_id": null,
          "airtable_record_url": null,
          "google_drive_id": null,
          "google_drive_url": null,
          "summary_updated_at": null,
          "sequential_id": 1,
          "slack_channels": [],
          "airtable_base_key": null,
          "airtable_table_name": null,
          "shortcut_task_id": null,
          "shortcut_task_url": null,
          "title_autogenerated": false,
          "view_source": null,
          "source": "web",
          "microsoft_teams_meeting_url": null,
          "microsoft_teams_meeting_id": null,
          "dropbox_paper_id": null,
          "dropbox_paper_url": null,
          "subscribers_count": 0,
          "status_page_io": {},
          "webex_meeting_id": null,
          "webex_meeting_url": null,
          "github_issue_id": null,
          "github_issue_url": null,
          "cancelled_at": null,
          "cancellation_message": null,
          "notion_page_id": null,
          "notion_page_url": null,
          "datadog_notebook_id": null,
          "datadog_notebook_url": null,
          "notify_channels": {},
          "freshservice_ticket_id": null,
          "freshservice_ticket_url": null,
          "freshservice_task_id": null,
          "freshservice_task_url": null,
          "started_by_user_id": 33,
          "mitigated_by_user_id": null,
          "resolved_by_user_id": null,
          "cancelled_by_user_id": null,
          "slack_aliases": [],
          "slack_channel_workspace_id": null,
          "google_calendar_event_url": null,
          "google_calendar_event_id": null,
          "short_url": null,
          "slack_channel_short_url": null,
          "go_to_meeting_id": null,
          "go_to_meeting_url": null,
          "jira_issue_key": null,
          "linear_issue_key": null,
          "opsgenie_alert_id": null,
          "opsgenie_alert_url": null,
          "triggered_from_slack_channel_id": null,
          "service_now_incident_key": null,
          "quip_page_id": null,
          "quip_page_url": null,
          "pagertree_alert_id": null,
          "pagertree_alert_url": null,
          "duplicate_incident_id": null,
          "parent_incident_id": null,
          "ability_cache": null,
          "previous_attributes": {
            "incident_events": [
              "Started date has been set to <span class=\"badge badge-info-inverted\">March 31  5:59 AM PDT</span>",
              "Fritz Stiedemann created this incident"
            ],
            "user_avatar_url": "data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KICAgICAg\nPHN2ZyB2ZXJzaW9uPSIxLjEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8y\nMDAwL3N2ZyIgd2lkdGg9IjIwMCIgaGVpZ2h0PSIyMDAiIHZpZXdCb3g9IjAg\nMCAyMDAgMjAwIj4KICAgICAgICA8bGluZWFyR3JhZGllbnQgaWQ9ImdyYWRp\nZW50XzE3NDM0MjU5NzhfODA0MzMxIiBncmFkaWVudFRyYW5zZm9ybT0icm90\nYXRlKDkwKSI+CiAgICAgICAgICA8c3RvcCBzdG9wLWNvbG9yPSIjMDAwNDI4\nIiBvZmZzZXQ9IjAlIiAvPgogICAgICAgICAgPHN0b3Agc3RvcC1jb2xvcj0i\nIzAwMDQyOCIgb2Zmc2V0PSIxMDAlIiAvPgogICAgICAgIDwvbGluZWFyR3Jh\nZGllbnQ+CiAgICAgICAgPHJlY3Qgd2lkdGg9IjEwMCUiIGhlaWdodD0iMTAw\nJSIgZmlsbD0idXJsKCNncmFkaWVudF8xNzQzNDI1OTc4XzgwNDMzMSkiIC8+\nCiAgICAgICAgPHRleHQgZmlsbD0iI0ZGRiIgZm9udC1mYW1pbHk9Ik9wZW4g\nU2FucyxIZWx2ZXRpY2EsQXJpYWwsc2Fucy1zZXJpZiIgZm9udC1zaXplPSIx\nMDEiIGZvbnQtd2VpZ2h0PSI1MDAiIHg9IjUwJSIgeT0iNTUlIiBkb21pbmFu\ndC1iYXNlbGluZT0ibWlkZGxlIiB0ZXh0LWFuY2hvcj0ibWlkZGxlIj4KICAg\nICAgICAgIEZTCiAgICAgICAgPC90ZXh0PgogICAgICA8L3N2Zz4KICAgIA==\n"
          },
          "genius_workflow_runs_count": 0,
          "slack_channel_archived": false,
          "google_drive_parent_id": null,
          "in_triage_at": null,
          "in_triage_by_user_id": null,
          "external_id": null,
          "slack_channel_deep_link": null,
          "retrospective_progress_status": "not_started",
          "users_assigned_count": 0,
          "retrospective_completed_at": null,
          "retrospective_started_at": null,
          "pagerduty_incident_number": null,
          "current_tutorial_step": "not_started",
          "clickup_task_id": null,
          "clickup_task_url": null,
          "slack_notify_ready_for_retrospective_timestamp": null,
          "notify_emails": [],
          "status_page_io_components": [],
          "retrospective_auto_skipped": false,
          "retrospective_mandatory": false,
          "embedding": null,
          "zoom_meeting_transcript": {},
          "google_meeting_transcript": {},
          "webex_meeting_transcript": {},
          "microsoft_teams_meeting_transcript": {},
          "zoom_meeting_bot_id": null,
          "google_meeting_bot_id": null,
          "webex_meeting_bot_id": null,
          "microsoft_teams_meeting_bot_id": null,
          "zoom_meeting_transcript_summary": null,
          "google_meeting_transcript_summary": null,
          "webex_meeting_transcript_summary": null,
          "microsoft_teams_meeting_transcript_summary": null,
          "gitlab_issue_id": null,
          "gitlab_issue_url": null,
          "outlook_event_id": null,
          "outlook_event_url": null,
          "sharepoint_page_id": null,
          "sharepoint_page_url": null,
          "created_from_slack_identifier": null,
          "zoom_meeting_pstn_password": null,
          "zoom_meeting_h323_password": null,
          "zoom_meeting_global_dial_in_numbers": [],
          "left_slack_channel_slack_user_ids": [],
          "using_redesigned_slack_announcement": true,
          "using_redesigned_slack_updates": true,
          "motion_task_id": null,
          "motion_task_url": null,
          "sub_status_id": "e2e1f34c-472c-4595-b33c-8f86bb37d984",
          "closed_at": null,
          "closed_by_user_id": null,
          "microsoft_teams_channel_id": null,
          "microsoft_teams_channel_name": null,
          "microsoft_teams_channel_url": null,
          "microsoft_teams_channel_short_url": null,
          "microsoft_teams_team_id": null,
          "triggered_from_microsoft_teams_channel_id": null,
          "microsoft_teams_summary_message_id": null,
          "slack_last_message_ts": null,
          "zoom_meeting_password": null,
          "microsoft_teams_channel_service_url": null,
          "microsoft_teams_team_internal_id": null,
          "triggered_from_slack_message_ts": null,
          "triggered_from_slack_thread_ts": null,
          "raw_labels": null,
          "tutorial_steps": null
        }
      ],
      "data": {},
      "started_at": "2025-03-31T05:59:37.655-07:00",
      "ended_at": null,
      "external_id": null,
      "external_url": "http://mertz-west.test/milo",
      "url": "https://test.rootly.com/account/alerts/fd65b9c1-496a-42b9-952f-8b6101dddb19",
      "notification_target_type": null,
      "notification_target_id": null,
      "alert_urgency_id": "cb93b5f1-8810-4abd-af57-b4cff08c8957",
      "notified_users": [],
      "created_at": "2025-03-31T05:59:37.655-07:00",
      "updated_at": "2025-03-31T05:59:44.818-07:00"
    }
  }
}

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Body

application/vnd.api+json
data
object
required

Response

200
application/vnd.api+json
alert updated
data
object
required