POST
/
v1
/
incidents
/
{incident_id}
/
alerts
Attach alerts to an incident
curl --request POST \
  --url https://api.rootly.com/v1/incidents/{incident_id}/alerts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '{
  "data": {
    "type": "alerts",
    "attributes": {
      "alert_ids": [
        "<string>"
      ]
    }
  }
}'
{
  "data": [
    {
      "id": "77ebb5fa-f11d-44ee-bfa1-a7bdbf5ac2f6",
      "type": "alerts",
      "attributes": {
        "short_id": "8fbw40",
        "source": "pagerduty",
        "status": "open",
        "summary": "Eos voluptatem nesciunt odit.",
        "description": "Impedit necessitatibus et. Fugiat necessitatibus blanditiis. Blanditiis dicta quam.",
        "labels": [],
        "services": [],
        "service_ids": [],
        "groups": [],
        "group_ids": [],
        "environments": [],
        "environment_ids": [],
        "responders": [],
        "incidents": [
          {
            "id": "bb7877f2-10c6-40e7-b189-d04b65a1b78c",
            "ability_cache": null,
            "acknowledged_at": null,
            "airtable_base_key": null,
            "airtable_record_id": null,
            "airtable_record_url": null,
            "airtable_table_name": null,
            "asana_task_id": null,
            "asana_task_url": null,
            "cancellation_message": null,
            "cancelled_at": null,
            "cancelled_by_user_id": null,
            "clickup_task_id": null,
            "clickup_task_url": null,
            "closed_at": null,
            "closed_by_user_id": null,
            "coda_doc_id": null,
            "coda_doc_url": null,
            "coda_page_id": null,
            "confluence_page_id": null,
            "confluence_page_url": null,
            "created_at": "2025-09-16T04:43:41.528-07:00",
            "created_from_slack_identifier": null,
            "current_tutorial_step": "not_started",
            "datadog_notebook_id": null,
            "datadog_notebook_url": null,
            "deleted_at": null,
            "detected_at": null,
            "dropbox_paper_id": null,
            "dropbox_paper_url": null,
            "duplicate_incident_id": null,
            "email_message_id": null,
            "embedding": null,
            "external_id": null,
            "freshservice_task_id": null,
            "freshservice_task_url": null,
            "freshservice_ticket_id": null,
            "freshservice_ticket_url": null,
            "genius_workflow_runs_count": 0,
            "github_issue_id": null,
            "github_issue_url": null,
            "gitlab_issue_id": null,
            "gitlab_issue_url": null,
            "go_to_meeting_id": null,
            "go_to_meeting_url": null,
            "google_calendar_event_id": null,
            "google_calendar_event_url": null,
            "google_drive_id": null,
            "google_drive_parent_id": null,
            "google_drive_url": null,
            "google_meeting_bot_id": null,
            "google_meeting_id": null,
            "google_meeting_transcript": {},
            "google_meeting_transcript_summary": null,
            "google_meeting_url": null,
            "in_triage_at": null,
            "in_triage_by_user_id": null,
            "incidents_action_items_count": 0,
            "incidents_tasks_count": 0,
            "jira_issue_id": null,
            "jira_issue_key": null,
            "jira_issue_url": null,
            "kind": "normal",
            "labels": {},
            "left_slack_channel_slack_user_ids": [],
            "linear_issue_id": null,
            "linear_issue_key": null,
            "linear_issue_url": null,
            "mattermost_channel_id": null,
            "mattermost_channel_name": null,
            "mattermost_channel_url": null,
            "mattermost_summary_timestamp": null,
            "microsoft_teams_channel_id": null,
            "microsoft_teams_channel_name": null,
            "microsoft_teams_channel_service_url": null,
            "microsoft_teams_channel_short_url": null,
            "microsoft_teams_channel_url": null,
            "microsoft_teams_meeting_bot_id": null,
            "microsoft_teams_meeting_id": null,
            "microsoft_teams_meeting_transcript": {},
            "microsoft_teams_meeting_transcript_summary": null,
            "microsoft_teams_meeting_url": null,
            "microsoft_teams_summary_message_id": null,
            "microsoft_teams_team_id": null,
            "microsoft_teams_team_internal_id": null,
            "mitigated_at": null,
            "mitigated_by_user_id": null,
            "mitigation_message": null,
            "motion_task_id": null,
            "motion_task_url": null,
            "notify_channels": {},
            "notify_emails": [],
            "notion_page_id": null,
            "notion_page_url": null,
            "opsgenie_alert_id": null,
            "opsgenie_alert_url": null,
            "opsgenie_incident_id": null,
            "opsgenie_incident_responder_ids": [],
            "opsgenie_incident_url": null,
            "outlook_event_id": null,
            "outlook_event_url": null,
            "pagerduty_incident_id": null,
            "pagerduty_incident_number": null,
            "pagerduty_incident_responder_ids": {},
            "pagerduty_incident_url": null,
            "pagertree_alert_id": null,
            "pagertree_alert_url": null,
            "parent_incident_id": null,
            "previous_attributes": {
              "updated_at": "2025-09-16T04:43:44.859-07:00",
              "incident_events": [
                "Alerts has been attached: <a class=\"badge badge-warning \" target=\"_blank\" data-toggle=\"tooltip\" data-placement=\"top\" data-title=\"[Pagerduty] Eos voluptatem nesciunt odit.\" href=\"http://streich-bernier.test/annie_doyle\">[Pagerduty] Eos voluptatem nesciunt odit.</a><a class=\"badge badge-warning \" target=\"_blank\" data-toggle=\"tooltip\" data-placement=\"top\" data-title=\"[Pagerduty] Magnam fuga ut ad.\" href=\"http://schinner-friesen.example/katharine.moore\">[Pagerduty] Magnam fuga ut ad.</a><a class=\"badge badge-warning \" target=\"_blank\" data-toggle=\"tooltip\" data-placement=\"top\" data-title=\"[Pagerduty] Exercitationem incidunt adipisci omnis.\" href=\"http://lubowitz-nolan.test/tricia\">[Pagerduty] Exercitationem incidunt adipisci omnis.</a>",
                "Started date has been set to <span class=\"badge badge-info-inverted\">September 16  4:43 AM PDT</span>",
                "Pamila Greenholt created this incident"
              ],
              "user_avatar_url": "data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KICAgICAg\nPHN2ZyB2ZXJzaW9uPSIxLjEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8y\nMDAwL3N2ZyIgd2lkdGg9IjIwMCIgaGVpZ2h0PSIyMDAiIHZpZXdCb3g9IjAg\nMCAyMDAgMjAwIj4KICAgICAgICA8bGluZWFyR3JhZGllbnQgaWQ9ImdyYWRp\nZW50XzE3NTgwMjMwMjZfNzA3NTk0IiBncmFkaWVudFRyYW5zZm9ybT0icm90\nYXRlKDEyMCkiPgogICAgICAgICAgPHN0b3Agc3RvcC1jb2xvcj0iIzYxNDM4\nNSIgb2Zmc2V0PSIwJSIgLz4KICAgICAgICAgIDxzdG9wIHN0b3AtY29sb3I9\nIiM2MTQzODUiIG9mZnNldD0iMTAwJSIgLz4KICAgICAgICA8L2xpbmVhckdy\nYWRpZW50PgogICAgICAgIDxyZWN0IHdpZHRoPSIxMDAlIiBoZWlnaHQ9IjEw\nMCUiIGZpbGw9InVybCgjZ3JhZGllbnRfMTc1ODAyMzAyNl83MDc1OTQpIiAv\nPgogICAgICAgIDx0ZXh0IGZpbGw9IiNGRkYiIGZvbnQtZmFtaWx5PSJPcGVu\nIFNhbnMsSGVsdmV0aWNhLEFyaWFsLHNhbnMtc2VyaWYiIGZvbnQtc2l6ZT0i\nMTAxIiBmb250LXdlaWdodD0iNTAwIiB4PSI1MCUiIHk9IjU1JSIgZG9taW5h\nbnQtYmFzZWxpbmU9Im1pZGRsZSIgdGV4dC1hbmNob3I9Im1pZGRsZSI+CiAg\nICAgICAgICBQRwogICAgICAgIDwvdGV4dD4KICAgICAgPC9zdmc+CiAgICA=\n"
            },
            "private": false,
            "public_title": null,
            "quip_page_id": null,
            "quip_page_url": null,
            "resolution_message": null,
            "resolved_at": null,
            "resolved_by_user_id": null,
            "retrospective_auto_skipped": false,
            "retrospective_completed_at": null,
            "retrospective_mandatory": false,
            "retrospective_progress_status": "not_started",
            "retrospective_started_at": null,
            "scheduled_auto_completed": true,
            "scheduled_auto_in_progress": true,
            "scheduled_for": null,
            "scheduled_remind_prior": false,
            "scheduled_until": null,
            "sequential_id": 1,
            "service_now_incident_id": null,
            "service_now_incident_key": null,
            "service_now_incident_url": null,
            "severity_id": "839fce6c-77a6-44b6-8a29-f2d3cdc01a3f",
            "sharepoint_page_id": null,
            "sharepoint_page_url": null,
            "short_url": null,
            "shortcut_story_id": null,
            "shortcut_story_url": null,
            "shortcut_task_id": null,
            "shortcut_task_url": null,
            "slack_aliases": [],
            "slack_channel_archived": false,
            "slack_channel_deep_link": null,
            "slack_channel_id": null,
            "slack_channel_name": null,
            "slack_channel_short_url": null,
            "slack_channel_url": null,
            "slack_channel_workspace_id": null,
            "slack_channels": [],
            "slack_last_message_ts": null,
            "slack_notify_ready_for_retrospective_timestamp": null,
            "slack_summary_timestamp": null,
            "slug": "recusandae-quaerat-saepe-dolor",
            "source": "web",
            "started_at": "2025-09-16T04:43:41.528-07:00",
            "started_by_user_id": 46,
            "status": "started",
            "status_page_io": {},
            "status_page_io_components": [],
            "status_pages_count": 0,
            "sub_incidents_count": 0,
            "sub_status_id": "d00d6d7c-455a-49d9-8807-bbf2f39062b4",
            "subscribers_count": 0,
            "summary": "Temporibus facilis nisi. Laboriosam aliquid iure. Eveniet possimus fugit.",
            "summary_updated_at": null,
            "team_id": 19,
            "title": "Recusandae quaerat saepe dolor.",
            "title_autogenerated": false,
            "trello_card_id": null,
            "trello_card_url": null,
            "triggered_from_microsoft_teams_channel_id": null,
            "triggered_from_slack_channel_id": null,
            "triggered_from_slack_message_ts": null,
            "triggered_from_slack_thread_ts": null,
            "updated_at": "2025-09-16T04:43:46.461-07:00",
            "user_id": 46,
            "users_assigned_count": 0,
            "using_redesigned_slack_announcement": true,
            "using_redesigned_slack_updates": true,
            "victor_ops_incident_id": null,
            "victor_ops_incident_responder_ids": {},
            "victor_ops_incident_url": null,
            "view_source": null,
            "webex_meeting_bot_id": null,
            "webex_meeting_id": null,
            "webex_meeting_transcript": {},
            "webex_meeting_transcript_summary": null,
            "webex_meeting_url": null,
            "zendesk_ticket_id": null,
            "zendesk_ticket_url": null,
            "zoom_meeting_bot_id": null,
            "zoom_meeting_global_dial_in_numbers": [],
            "zoom_meeting_h323_password": null,
            "zoom_meeting_id": null,
            "zoom_meeting_join_url": null,
            "zoom_meeting_password": null,
            "zoom_meeting_pstn_password": null,
            "zoom_meeting_start_url": null,
            "zoom_meeting_transcript": {},
            "zoom_meeting_transcript_summary": null,
            "raw_labels": null,
            "tutorial_steps": null
          }
        ],
        "data": {},
        "deduplication_key": null,
        "started_at": "2025-09-16T04:43:43.779-07:00",
        "ended_at": null,
        "external_id": null,
        "external_url": "http://streich-bernier.test/annie_doyle",
        "url": "https://test.rootly.com/account/alerts/77ebb5fa-f11d-44ee-bfa1-a7bdbf5ac2f6",
        "noise": "not_noise",
        "notification_target_type": null,
        "notification_target_id": null,
        "alert_urgency": {
          "id": "f6f305ba-1e07-41dd-a9ec-7c5ee1e0e801",
          "color": "#C73C40",
          "created_at": "2025-09-16T04:43:44.149-07:00",
          "deleted_at": null,
          "description": "Accusamus temporibus eius adipisci.",
          "name": "9qkf1",
          "position": 1,
          "team_id": 27,
          "updated_at": "2025-09-16T04:43:44.156-07:00",
          "urgency": "high"
        },
        "alert_urgency_id": "f6f305ba-1e07-41dd-a9ec-7c5ee1e0e801",
        "notified_users": [],
        "created_at": "2025-09-16T04:43:43.779-07:00",
        "updated_at": "2025-09-16T04:43:43.779-07:00"
      },
      "relationships": {
        "events": {
          "data": [
            {
              "id": "c3c8cff8-2b1b-42b5-8c16-18e3c18fcb2b",
              "type": "alert_events"
            }
          ]
        }
      }
    }
  ],
  "links": {
    "self": "http://www.example.com/v1/incidents/bb7877f2-10c6-40e7-b189-d04b65a1b78c/alerts?page%5Bnumber%5D=1&page%5Bsize%5D=10",
    "first": "http://www.example.com/v1/incidents/bb7877f2-10c6-40e7-b189-d04b65a1b78c/alerts?page%5Bnumber%5D=1&page%5Bsize%5D=10",
    "prev": null,
    "next": null,
    "last": "http://www.example.com/v1/incidents/bb7877f2-10c6-40e7-b189-d04b65a1b78c/alerts?page%5Bnumber%5D=1&page%5Bsize%5D=10"
  }
}

Authorizations

Authorization
string
header
required

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

Path Parameters

incident_id
string
required

Body

application/vnd.api+json
data
object
required

Response

alert created

data
object[]
required