---
title: "List Incident Updates V2"
method: GET
path: "/v2/incident_updates"
tags: ["Incident Updates V2"]
---

# List Incident Updates V2

`GET /v2/incident_updates`

List all incident updates for an organisation, or for a specific incident.

## Query parameters

- `incident_id` string
- `page_size` integer
- `after` string

## Response `200`

OK response.

- IncidentUpdatesV2ListResponseBody
  - `incident_updates` IncidentUpdateV2[], required
    - `created_at` string, date-time, required — When the update was created
    - `id` string, required — Unique identifier for this incident update
    - `incident_id` string, required — The incident this update relates to
    - `merged_into_incident_id` string — The ID of the incident that this incident was merged into, if it was merged in to another incident
    - `message` string — Message that explains the context behind the update
    - `new_incident_status` IncidentStatusV2, required
      - `category` 'triage' | 'declined' | 'merged' | 'canceled' | 'live' | 'learning' | 'closed' | 'paused', required — What category of status it is. All statuses apart from live (renamed in the app to Active) and learning (renamed in the app to Post-incident) are managed by incident.io and cannot be configured
      - `created_at` string, date-time, required
      - `description` string, required — Rich text description of the incident status
      - `id` string, required — Unique ID of this incident status
      - `name` string, required — Unique name of this status
      - `rank` integer, required — Order of this incident status
      - `updated_at` string, date-time, required
    - `new_severity` SeverityV2
      - `created_at` string, date-time, required — When the action was created
      - `description` string, required — Description of the severity
      - `id` string, required — Unique identifier of the severity
      - `name` string, required — Human readable name of the severity
      - `rank` integer, required — Rank to help sort severities (lower numbers are less severe)
      - `updated_at` string, date-time, required — When the action was last updated
    - `updater` ActorV2, required
      - `api_key` APIKeyV2
        - `id` string, required — Unique identifier for this API key
        - `name` string, required — The name of the API key, for the user's reference
      - `user` UserV2
        - `email` string — Email address of the user.
        - `id` string, required — Unique identifier of the user
        - `name` string, required — Name of the user
        - `role` 'viewer' | 'responder' | 'administrator' | 'owner' | 'unset', required — DEPRECATED: Role of the user as of March 9th 2023, this value is no longer updated.
        - `slack_user_id` string — Slack ID of the user
  - `pagination_meta` PaginationMetaResult
    - `after` string — If provided, pass this as the 'after' param to load the next page
    - `page_size` integer, required — What was the maximum number of results requested

---

[API](https://skmtc.net/incident/apis/incident-io.md) · [All operations](https://skmtc.net/incident/apis/incident-io/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/incident/incident-io/revisions/602fc25ddd76/schema)