Incidents

Update incident

PATCH/api/v1/incidents/:id

Updates an incident's description or severity. To change only the status, use the dedicated status endpoint instead — it's the one that triggers a notification.

Requires Authorization

ADMIN, SUPPORT only

Authenticated action

Path parameters

idstringrequired

Incident ID.

Body parameters

`description`string	Up to 5000 characters.
`severity`string	MINOR, MAJOR, or CRITICAL.
`status`string	Also accepted here, but prefer PATCH /:id/status.

Request

curl --request PATCH \
  --url https://api.swiftgoma.com/api/v1/incidents/:id \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "description": "<description>",
  "severity": "<severity>",
  "status": "<status>"
}'

200Example response

{
  "success": true,
  "data": {
    "id": "inc_1a2b3c",
    "title": "Retards de livraison à Goma",
    "description": "Certains livreurs rencontrent des retards liés aux conditions de circulation.",
    "severity": "MINOR",
    "status": "INVESTIGATING",
    "resolvedAt": null,
    "createdAt": "2026-02-15T08:00:00.000Z",
    "updatedAt": "2026-02-15T08:00:00.000Z"
  }
}