Skip to content
Sencai Logo Sencai Logo Sencai Docs

Create a cost-anomaly

POST
/cost-anomalies

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
object
data
object
org_id
required

Organisation documentId the anomaly belongs to.

string
resource_id

Cloud-instance documentId or service name. Null = org-total anomaly.

string
resource_type
string
Allowed values: cloud_instance service database network total
expected_usd

Expected cost derived from historical baseline (IQR median or mean).

number
actual_usd
required

Observed cost that triggered the anomaly.

number
deviation_pct

Signed percentage deviation: (actual - expected) / expected * 100.

number
detection_method
string
Allowed values: iqr z_score threshold
status
string
Allowed values: open acknowledged false_positive
acknowledged_at
string format: date-time
acknowledged_by

User ID (Strapi numeric id or email) who acknowledged the anomaly.

string

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Created

object
data
object
org_id
required

Organisation documentId the anomaly belongs to.

string
resource_id

Cloud-instance documentId or service name. Null = org-total anomaly.

string
resource_type
string
Allowed values: cloud_instance service database network total
expected_usd

Expected cost derived from historical baseline (IQR median or mean).

number
actual_usd
required

Observed cost that triggered the anomaly.

number
deviation_pct

Signed percentage deviation: (actual - expected) / expected * 100.

number
detection_method
string
Allowed values: iqr z_score threshold
status
string
Allowed values: open acknowledged false_positive
acknowledged_at
string format: date-time
acknowledged_by

User ID (Strapi numeric id or email) who acknowledged the anomaly.

string
documentId
string
id
integer
createdAt
string format: date-time
updatedAt
string format: date-time
publishedAt
string format: date-time
nullable

400

Section titled “400 ”

Validation error

401

Section titled “401 ”

Missing or invalid authentication

403

Section titled “403 ”

Not authorized (tenant scope or capability)