Skip to main content
GET
List cost anomalies for a cloud Connection.
Scope: optimize:anomalies: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

connection_id
string<uuid>
required

Cloud Connection with cost data. Find one with workspace.connections.list?product=optimize.

range
enum<string>

Look-back window. Default 30d.

Available options:
30d,
90d
severity
enum<string>

Only this severity.

Available options:
critical,
high,
medium,
low,
info
state
enum<string>

Only this review state.

Available options:
needs_review,
investigating,
reviewed
disposition
enum<string>

Only this disposition.

Available options:
unexpected_change,
expected_change,
insignificant
detection
enum<string>

Only this detection state.

Available options:
detected,
retracted
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

Cost anomalies, newest first.

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

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