Skip to main content
GET
List incidents, newest first.
Scope: resolve:incidents:read. 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.

Path Parameters

workspace_id
string<uuid>
required

Workspace to act in. Every call names it.

Query Parameters

status
enum<string>[]

Only these statuses.

Available options:
OPEN,
ACKNOWLEDGED,
INVESTIGATING,
IDENTIFIED,
ON_HOLD,
NOT_FOUND,
FALSE_ALARM,
RESOLVED,
AUTO_RESOLVED
bucket
enum<string>[]

Only these queue buckets.

Available options:
ai_handling,
needs_decision,
not_started,
resolved,
dismissed
severity
enum<string>[]

Only these severities.

Available options:
critical,
high,
medium,
low,
info

Text in the title or description.

Maximum string length: 200
from
string<date-time>

Only incidents that occurred at or after this time.

to
string<date-time>

Only incidents that occurred before this time.

awaiting
boolean

Only incidents with a runbook step waiting for approval.

children
boolean

Also list child incidents.

limit
integer
default:20

Items per page.

Required range: 1 <= x <= 100
cursor
string

next_cursor from the previous page.

Maximum string length: 512

Response

OK

Incidents, newest first.

items
Incident · object[]
required
next_cursor
string | null
required

Pass back as cursor for the next page. Null on the last page.