Skip to main content
PATCH
Change an incident's status or severity.
Scope: resolve:incidents:write. See API Tokens.

Authorizations

Authorization
string
header
required

CloudThinker token: a personal access token ct_pat_… (fine-grained scopes, created in Settings) or an OAuth access token ct_oat_… (1 hour, from the OAuth flow). Send Authorization: Bearer <token>. Scopes have the form module:resource:read|write; write includes read.

Headers

If-Match
string
required

The ETag from the last GET. A mismatch returns 412.

Idempotency-Key
string

Unique per logical write. A retry with the same key and body returns the first result.

Required string length: 1 - 255

Path Parameters

workspace_id
string<uuid>
required

Workspace to act in. Every call names it.

incident_id
string<uuid>
required

Incident id.

Body

application/json

Send status, severity or both.

status
enum<string>
Available options:
OPEN,
ACKNOWLEDGED,
INVESTIGATING,
IDENTIFIED,
ON_HOLD,
NOT_FOUND,
FALSE_ALARM,
RESOLVED,
AUTO_RESOLVED
severity
enum<string>
Available options:
critical,
high,
medium,
low,
info

Response

OK

One incident. GET returns an ETag; send it as If-Match on update.

id
string<uuid>
required
title
string
required
description
string | null
required
severity
enum<string>
required
Available options:
critical,
high,
medium,
low,
info
status
enum<string>
required
Available options:
OPEN,
ACKNOWLEDGED,
INVESTIGATING,
IDENTIFIED,
ON_HOLD,
NOT_FOUND,
FALSE_ALARM,
RESOLVED,
AUTO_RESOLVED
queue
IncidentQueueState · object | null
required
investigation_phase
enum<string>
required
Available options:
quiet,
active_response,
retrospective
triage_assessment
enum<string>
required
Available options:
pending,
no_action_needed,
issue,
incident_warranted,
inconclusive
triage_reason
string | null
required
response_level
enum<string> | null
required
Available options:
page_responders,
track_only
declaration_mode
enum<string>
required
Available options:
active_response,
retrospective
declared_at
string<date-time> | null
required
source
enum<string>
required
Available options:
webhook,
manual,
api
platform_type
string | null
required
conversation_id
string<uuid> | null
required
incident_room_id
string<uuid> | null
required
parent_incident_id
string<uuid> | null
required
child_count
integer
required
affected_services
AffectedService · object[]
required
correlated_alert_count
integer
required
first_alert_at
string<date-time> | null
required
last_alert_at
string<date-time> | null
required
occurred_at
string<date-time>
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
resolved_at
string<date-time> | null
required
closed_at
string<date-time> | null
required