Skip to main content
POST
/
v1
/
alerts
/
{id}
/
acknowledge
Acknowledges an alert
curl --request POST \
  --url https://api.rootly.com/v1/alerts/{id}/acknowledge \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "id": "b197d8b3-fc79-42de-849d-1210382f838e",
    "type": "alerts",
    "attributes": {
      "short_id": "ALT100005",
      "source": "pagerduty",
      "status": "acknowledged",
      "summary": "Test alert 5",
      "description": "Test alert description",
      "labels": [],
      "services": [],
      "service_ids": [],
      "groups": [],
      "group_ids": [],
      "environments": [],
      "environment_ids": [],
      "responders": [
        {
          "id": 72,
          "ability_cache": null,
          "accept_marketing": true,
          "accept_terms": true,
          "created_at": "2025-11-27T00:05:32.055-08:00",
          "created_through_sso": false,
          "current_team_id": 23,
          "deleted_at": null,
          "email": "lorina@orn.example",
          "external_id": null,
          "first_name": "Thurman",
          "has_impersonate_write_permission": false,
          "how_did_you_hear_about_us": null,
          "incidents_backfilled_count": 0,
          "incidents_count": 0,
          "incidents_example_count": 0,
          "incidents_normal_count": 0,
          "incidents_scheduled_count": 0,
          "incidents_test_count": 0,
          "is_super_admin": false,
          "jti": "7a35fb0c-6ea4-4d3b-a8da-b4a8cc578cb7",
          "last_name": "Sipes",
          "last_notification_email_sent_at": null,
          "last_seen_at": null,
          "locale": "en",
          "onboarding_completed": true,
          "opsgenie_id": null,
          "pagerduty_id": null,
          "profile_photo_id": null,
          "push_notification_new_alert_sound": "default",
          "push_notification_new_alert_volume": 1,
          "push_notification_shift_ends_sound": "soft_bloob",
          "push_notification_shift_starts_sound": "soft_bloob",
          "scim_uid": null,
          "service_user": false,
          "session_token": null,
          "skip_tutorial": false,
          "teams_count": 1,
          "theme": "light_v2",
          "time_zone": "UTC",
          "updated_at": "2025-11-27T00:05:32.428-08:00",
          "victor_ops_id": null,
          "view_multiple_schedules": true
        }
      ],
      "incidents": [
        {
          "id": "adde624a-5dc2-4a2a-a2c8-21a35f8bbc64",
          "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-11-27T00:05:33.418-08: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_epic_id": null,
          "jira_epic_key": null,
          "jira_epic_url": null,
          "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,
          "parent_to_sub_incident_sync": false,
          "previous_attributes": {
            "updated_at": "2025-11-27T00:05:33.556-08:00",
            "incident_events": [
              "Started date has been set to <span class=\"badge badge-info-inverted\">November 27 12:05 AM PST</span>",
              "Eddie O'Hara created this incident"
            ],
            "user_avatar_url": "data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KICAgICAg\nPHN2ZyB2ZXJzaW9uPSIxLjEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8y\nMDAwL3N2ZyIgd2lkdGg9IjIwMCIgaGVpZ2h0PSIyMDAiIHZpZXdCb3g9IjAg\nMCAyMDAgMjAwIj4KICAgICAgICA8bGluZWFyR3JhZGllbnQgaWQ9ImdyYWRp\nZW50XzE3NjQyMzA3MzdfMjA0NzI3IiBncmFkaWVudFRyYW5zZm9ybT0icm90\nYXRlKDEyMCkiPgogICAgICAgICAgPHN0b3Agc3RvcC1jb2xvcj0iIzA2YmVi\nNiIgb2Zmc2V0PSIwJSIgLz4KICAgICAgICAgIDxzdG9wIHN0b3AtY29sb3I9\nIiMwNmJlYjYiIG9mZnNldD0iMTAwJSIgLz4KICAgICAgICA8L2xpbmVhckdy\nYWRpZW50PgogICAgICAgIDxyZWN0IHdpZHRoPSIxMDAlIiBoZWlnaHQ9IjEw\nMCUiIGZpbGw9InVybCgjZ3JhZGllbnRfMTc2NDIzMDczN18yMDQ3MjcpIiAv\nPgogICAgICAgIDx0ZXh0IGZpbGw9IiNGRkYiIGZvbnQtZmFtaWx5PSJPcGVu\nIFNhbnMsSGVsdmV0aWNhLEFyaWFsLHNhbnMtc2VyaWYiIGZvbnQtc2l6ZT0i\nMTAxIiBmb250LXdlaWdodD0iNTAwIiB4PSI1MCUiIHk9IjU1JSIgZG9taW5h\nbnQtYmFzZWxpbmU9Im1pZGRsZSIgdGV4dC1hbmNob3I9Im1pZGRsZSI+CiAg\nICAgICAgICBFTwogICAgICAgIDwvdGV4dD4KICAgICAgPC9zdmc+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": "8a815dbb-b7a1-4218-a73a-aef7aec3fdb0",
          "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": "aliquid-est-sunt-id",
          "source": "web",
          "started_at": "2025-11-27T00:05:33.418-08:00",
          "started_by_user_id": 74,
          "status": "started",
          "status_page_io": {},
          "status_page_io_components": [],
          "status_pages_count": 0,
          "sub_incidents_count": 0,
          "sub_status_id": "bd06f5d8-2e8e-4651-8857-3576c3fd427a",
          "subscribers_count": 0,
          "summary": "Aut nesciunt molestias. Sint nulla est. Minus facere sed.",
          "summary_updated_at": null,
          "team_id": 23,
          "title": "Aliquid est sunt id.",
          "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-11-27T00:05:37.676-08:00",
          "user_id": 74,
          "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-11-27T00:05:36.410-08:00",
      "ended_at": null,
      "external_id": null,
      "external_url": "https://example.com/alert/test",
      "url": "https://test.rootly.com/account/alerts/b197d8b3-fc79-42de-849d-1210382f838e",
      "noise": "not_noise",
      "notification_target_type": null,
      "notification_target_id": null,
      "alert_urgency": {
        "id": "ba559575-ae35-48dd-86b5-9f0cf6bd2405",
        "color": "#C73C40",
        "created_at": "2025-11-27T00:05:36.400-08:00",
        "deleted_at": null,
        "description": "Consectetur velit tempore quo.",
        "name": "qzl3r",
        "position": 1,
        "team_id": 31,
        "updated_at": "2025-11-27T00:05:36.408-08:00",
        "urgency": "high"
      },
      "alert_urgency_id": "ba559575-ae35-48dd-86b5-9f0cf6bd2405",
      "notified_users": [],
      "created_at": "2025-11-27T00:05:36.411-08:00",
      "updated_at": "2025-11-27T00:06:02.449-08:00"
    },
    "relationships": {
      "events": {
        "data": [
          {
            "id": "ea36975e-008c-4da1-b201-f4745c295941",
            "type": "alert_events"
          },
          {
            "id": "ca65c460-48f0-4057-8fad-b6a41b0a6de8",
            "type": "alert_events"
          },
          {
            "id": "b403402e-1600-4b05-bf37-34017edd90d6",
            "type": "alert_events"
          }
        ]
      }
    }
  }
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required

Response

alert acknowledged

​
data
object
required