---
title: "Update incident"
method: POST
path: "/api/v1/incidents/{incidentId}"
tags: ["Incidents"]
---

# Update incident

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

## Request

- Base URL: `https://cloud.soda.io`
- URL: `https://cloud.soda.io/api/v1/incidents/{incidentId}`
- Auth: one of:
  - HTTP basic
  - API key in cookie `token`
- TypeScript: <https://skmtc.dev/soda/apis/soda-cloud-api-v4/docs/api/v1/incidents/:incidentId/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint enables you to update an existing incident title, severity, status, or description in your organization's Soda Cloud account.

## Authorization

Only users with **Manage incident** permission can update incidents. Soda Cloud Admins have permission to update all incidents.**See [Manage dataset roles](https://go.soda.io/roles-dataset) for more information.**

## Authentication

User authentication required: `true`

This endpoint accepts authentication via API keys in the `Basic` authentication header, or a pre-authenticated token in HTTP cookie `token`. Cookie sessions extend automatically on each request.

## Tags

`Incidents`

## Rate limiting

10 requests/60 seconds

## Path parameters

- `incidentId` string, required

## Request body

- PublicApiUpdateIncidentDTO
  - `description` string
  - `resolutionNotes` string
  - `severity` 'minor' | 'major' | 'critical'
  - `status` 'reported' | 'investigating' | 'fixing' | 'resolved'
  - `title` string

## Response `200`

Successful response

- IncidentContentDTO
  - `description` string, required
  - `resolutionNotes` string
  - `severity` 'minor' | 'major' | 'critical', required
  - `cloudUrl` string
  - `id` string
  - `name` string
  - `number` integer
  - `status` 'reported' | 'investigating' | 'fixing' | 'resolved'

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `429`: Too many requests
- `500`: Internal server error

---

[API](https://skmtc.dev/soda/apis/soda-cloud-api-v4.md) - [All operations](https://skmtc.dev/soda/apis/soda-cloud-api-v4/llms.txt) - [OpenAPI document](https://skmtc.dev/soda/apis/soda-cloud-api-v4/revisions/ce87192b6b72?raw)