billing

Update usage-alert settings

Changed on

Configures the low-balance alert: while enabled and the balance sits below the threshold, an alert stays open and surfaces in the dashboard. Negative-balance alerts are always on. Requires an admin-role caller: an API key carries its creator's organization role, so the key must belong to an org admin.

patch/billing/usage-alerts

Request

Request body

$schemastring uri

A URL to the JSON Schema for this object.

enabledboolean

Whether low-balance alerts are active.

threshold_microdollarsinteger

Alert while the balance sits below this amount, in microdollars. Must be positive while enabled.

Example request

{
  "$schema": "/api/v1/SubscriptionUsageAlertSettingsUpdate.json"
}

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

enabledboolean required

Whether low-balance alerts are active. Negative-balance alerts are always on.

threshold_microdollarsinteger required

Alert while the balance sits below this amount, in microdollars. Must be positive while enabled.

Example response

{
  "$schema": "/api/v1/SubscriptionUsageAlertSettingsResponse.json"
}

Changes