---
title: "Add a new incident update to a specific incident."
method: POST
path: "/v1/status-pages/incidents/{incidentId}/incident-updates"
tags: ["Status Page Incidents"]
deprecated: true
---

# Add a new incident update to a specific incident.

`POST /v1/status-pages/incidents/{incidentId}/incident-updates`

## Request

- Base URL: `https://api.checklyhq.com`
- URL: `https://api.checklyhq.com/v1/status-pages/incidents/{incidentId}/incident-updates`
- Auth: HTTP bearer

> **Deprecated.**

Creates a new update for an incident.

Use the [Status Pages v3 API](/api-reference/status-pages-v3/list-v3-status-pages) for new integrations.

## Path parameters

- `incidentId` string, required

## Headers

- `x-checkly-account` string: Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

## Request body

- StatusPageV2IncidentUpdate
  - `id` string
  - `description` string, required
  - `status` 'INVESTIGATING' | 'IDENTIFIED' | 'MONITORING' | 'RESOLVED'
  - `publicIncidentUpdateDate` string, date-time
  - `created_at` string, date
  - `notifySubscribers` boolean

## Response `200`

Successful

- StatusPageV2IncidentUpdate
  - `id` string
  - `description` string, required
  - `status` 'INVESTIGATING' | 'IDENTIFIED' | 'MONITORING' | 'RESOLVED'
  - `publicIncidentUpdateDate` string, date-time
  - `created_at` string, date
  - `notifySubscribers` boolean

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests

## Changes

- **2026-10-31** `bc90d1bfa738`: 3 info
  - the `publicIncidentUpdateDate` request property default value changed from `2026-10-05T01:01:23.752Z` to `2026-10-29T19:59:23.378Z`
  - added the optional property `errorCode` to the response with the `403` status
  - the `publicIncidentUpdateDate` response's property default value changed from `2026-10-05T01:01:23.752Z` to `2026-10-29T19:59:23.378Z` for the status `200`
- **2026-10-07** `aba5d34c749b`: 3 info
  - endpoint deprecated
  - the `publicIncidentUpdateDate` request property default value changed from `2026-08-11T02:46:47.038Z` to `2026-10-05T01:01:23.752Z`
  - the `publicIncidentUpdateDate` response's property default value changed from `2026-08-11T02:46:47.038Z` to `2026-10-05T01:01:23.752Z` for the status `200`
- **2026-08-12** `87d29dc7b4fe`: 2 info
  - the `publicIncidentUpdateDate` request property default value changed from `2026-08-03T03:10:39.274Z` to `2026-08-11T02:46:47.038Z`
  - the `publicIncidentUpdateDate` response's property default value changed from `2026-08-03T03:10:39.274Z` to `2026-08-11T02:46:47.038Z` for the status `200`
- **2026-08-05** `9e903da4f3da`: 2 info
  - the `publicIncidentUpdateDate` request property default value changed from `2026-07-13T03:11:27.207Z` to `2026-08-03T03:10:39.274Z`
  - the `publicIncidentUpdateDate` response's property default value changed from `2026-07-13T03:11:27.207Z` to `2026-08-03T03:10:39.274Z` for the status `200`
- …earlier changes not shown

[Operation history](https://skmtc.dev/checklyhq/apis/checkly-public-api/changes/v1/status-pages/incidents/:incidentId/incident-updates/post.md)

---

[API](https://skmtc.dev/checklyhq/apis/checkly-public-api.md) - [All operations](https://skmtc.dev/checklyhq/apis/checkly-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/checklyhq/apis/checkly-public-api/revisions/bc90d1bfa738?raw)