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

# Update an incident update

`PUT /v1/incidents/{incidentId}/updates/{id}`

## Request

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

Modifies an incident update.

## Path parameters

- `id` string, required
- `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

- IncidentUpdateV1UpdateRequest
  - `description` string, required: A description about the status update.

## Response `200`

Successful

- IncidentUpdateV1Response
  - `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, required: The timestamp when last the update.

## 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 info
  - added the non-success response with the status `400`

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