---
title: "Create an incident update"
method: POST
path: "/v1/incidents/{incidentId}/updates"
tags: ["Incident Updates"]
---

# Create an incident update

`POST /v1/incidents/{incidentId}/updates`

## Request

- Base URL: `https://api.checklyhq.com`
- URL: `https://api.checklyhq.com/v1/incidents/{incidentId}/updates`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/checklyhq/apis/checkly-public-api/docs/v1/incidents/:incidentId/updates/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new update for an incident.

## 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

- IncidentUpdateV1CreateRequest
  - `status` 'INVESTIGATING' | 'IDENTIFIED' | 'MONITORING' | 'RESOLVED' | 'MAINTENANCE', required: The incident update status. Must be one of INVESTIGATING,IDENTIFIED,MONITORING,RESOLVED,MAINTENANCE
  - `description` string, required: A description about the status update.

## Response `201`

Created

- IncidentUpdateV1CreateResponse
  - `status` 'INVESTIGATING' | 'IDENTIFIED' | 'MONITORING' | 'RESOLVED' | 'MAINTENANCE', required: The incident update status. Must be one of INVESTIGATING,IDENTIFIED,MONITORING,RESOLVED,MAINTENANCE
  - `description` string, required: A description about the status update.
  - `id` string, required: The incident update universal and unique identificator.
  - `created_at` string, date-time, required: The timestamp when the incident update was created.
  - `updated_at` string, date-time, nullable
  - `incidentId` string, required

## Other responses

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

## Changes

- **2026-10-31** `bc90d1bfa738`: 2 info
  - added the optional property `errorCode` to the response with the `400` status
  - added the optional property `errorCode` to the response with the `403` status
- **2026-08-12** `87d29dc7b4fe`: 1 breaking, 2 info
  - removed the success response with the status `200`
  - added the non-success response with the status `400`
  - added the success response with the status `201`

[Operation history](https://skmtc.dev/checklyhq/apis/checkly-public-api/changes/v1/incidents/:incidentId/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)