Sign in

v7

latestOpenAPI 3.1.02026-08-08356409701.0 KB
Usage Alerts

Create Usage Alert Endpoint

post/v1/usage-alerts

Headers

X-API-Keystring required

API key required to authenticate requests.

Request body

namestring required

Human-readable alert name

alert_type'low_remaining_contract_credit_percentage_reached' | 'low_remaining_contract_credit_balance_reached' | 'spend_threshold_reached' required

the native Metronome alert types we expose, as-is, for usage alerts.

contracts are credits-only, so we alert on remaining balance: percentage (running-low and exhaustion at 0%) and absolute credit balance. spend is kept for legacy/overage-depth alerts.

thresholdnumber required

Threshold in the type's native unit (% , $, or 0 for into-overage)

Response

Successful Response

idstring uuid required
namestring required
metronome_alert_idstring required
is_enabledboolean required
thresholdnumber nullable
alert_typestring nullable
statusstring nullable