---
title: "Update incident"
method: PATCH
path: "/v2/incidents/{incidentId}"
tags: ["incidents"]
---

# Update incident

`PATCH /v2/incidents/{incidentId}`

## Request

- Base URL: `https://api.cloudzero.com`
- URL: `https://api.cloudzero.com/v2/incidents/{incidentId}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/cloudzero/apis/cloudzero-api-v2-resources/docs/v2/incidents/:incidentId/patch.ts> (a function with typed inputs; its response is checked against the schema)

Moves an incident to any status. `resolved` requires `resolution_reason`; other statuses reject resolution fields. Returns 409 if the status changed concurrently or the monitor is deleted.

## Path parameters

- `incidentId` string, required: The ID of the incident

## Request body

- UpdateIncidentStatusRequest: The status to move an incident to. Moving an incident out of `resolved` clears its `resolution_reason` and `resolution_reason_detail`.
  - `resolution_reason` 'intentional' | 'remediated' | 'self_resolved' | 'not_an_anomaly'
  - `resolution_reason_detail` string, nullable: Optional note on the resolution. Only allowed when `status` is `resolved`.
  - `status` 'active' | 'investigating' | 'resolved', required

## Response `200`

Successful Response

- IncidentStatusUpdate: An incident's status after a status change.
  - `incident_id` string, required: Unique identifier for the incident
  - `resolution_reason` 'intentional' | 'remediated' | 'self_resolved' | 'not_an_anomaly', required
  - `resolution_reason_detail` string, nullable, required: Note recorded when the incident was resolved; null when none was given
  - `status` 'active' | 'investigating' | 'resolved', required

## Other responses

- `401`: Unauthorized: the API key is missing or invalid (gateway `{"message": ...}` body), or the key carries no organization
- `403`: Forbidden: the API key lacks the scope for this operation (gateway `{"message": ...}` body)
- `404`: Not found: the resource does not exist or belongs to another organization
- `409`: Conflict: the change conflicts with the current state of the resource; re-read and retry
- `422`: A parameter failed validation; `details` lists each field failure when present

## Changes

- **2026-11-03** `56a692cf51b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cloudzero/apis/cloudzero-api-v2-resources/changes/v2/incidents/:incidentId/patch.md)

---

[API](https://skmtc.dev/cloudzero/apis/cloudzero-api-v2-resources.md) - [All operations](https://skmtc.dev/cloudzero/apis/cloudzero-api-v2-resources/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudzero/apis/cloudzero-api-v2-resources/revisions/56a692cf51b1?raw)