DivisionCero

Update an incident

PATCH
/incidents/{id}

Only the fields sent change; null clears an optional one. Requires incidents.write.

Authorization

apiKey
headerAuthorizationBearer <token>

Path Parameters

id*string
Formatuuid

Request Body

application/json
  1. body
title?string
Length1 <= length <= 200
description?|null
category_id?string

An incident category of the team (GET /incidents/catalogs)

Formatuuid
detection_source_id?string

A detection source of the team (GET /incidents/catalogs)

Formatuuid
status_id?string
Formatuuid
occurred_on?|null
detected_on?string

Defaults to today (UTC)

Formatdate
affected_systems?|null
impact?|null
personal_data_involved?boolean
owner_user_id?|

A member of the team

containment_actions?|null
resolution?|null
resolved_on?|

Required when the status closes the incident

root_cause?|null
lessons_learned?|null
improvements?|null

Response Body

OK

application/json
  1. response
id*string
Formatuuid
code*string
title*string
description*string|null
category_id*string
Formatuuid
detection_source_id*string
Formatuuid
status_id*string
Formatuuid
occurred_on*|null
detected_on*string

Date, YYYY-MM-DD

affected_systems*string|null
impact*string|null
personal_data_involved*boolean
owner_user_id*|null
containment_actions*string|null
resolution*string|null
resolved_on*|null
root_cause*string|null
lessons_learned*string|null
improvements*string|null
created_at*string

ISO 8601 timestamp

updated_at*string

ISO 8601 timestamp

Example Request
curl -X PATCH 'https://app.divisioncero.com/api/v1/incidents/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response200
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "code": "string",  "title": "string",  "description": "string",  "category_id": "8de4c9fd-61a4-4c0b-bf88-0ed3a0fe3fa2",  "detection_source_id": "caa22f20-0610-404c-83e1-ae444f943b9a",  "status_id": "4e949624-bc0f-439e-a9f2-25a23938812c",  "occurred_on": "string",  "detected_on": "string",  "affected_systems": "string",  "impact": "string",  "personal_data_involved": true,  "owner_user_id": "65139110-7c3c-4777-b692-80c218be3b9d",  "containment_actions": "string",  "resolution": "string",  "resolved_on": "string",  "root_cause": "string",  "lessons_learned": "string",  "improvements": "string",  "created_at": "string",  "updated_at": "string"}

How is this guide?