Skip to content
Primary navigation

Spend Alerts

List organization spend alerts
$ openai admin:organization:spend-alerts list
GET/organization/spend_alerts
Create organization spend alert
$ openai admin:organization:spend-alerts create
POST/organization/spend_alerts
Update organization spend alert
$ openai admin:organization:spend-alerts update
POST/organization/spend_alerts/{alert_id}
Delete organization spend alert
$ openai admin:organization:spend-alerts delete
DELETE/organization/spend_alerts/{alert_id}
ModelsExpand Collapse
organization_spend_alert: object { id, currency, interval, 3 more }

Represents a spend alert configured at the organization level.

id: string

The identifier, which can be referenced in API endpoints.

currency: "USD"

The currency for the threshold amount.

"USD"
interval: "month"

The time interval for evaluating spend against the threshold.

"month"
notification_channel: object { recipients, type, subject_prefix }

Email notification settings for a spend alert.

recipients: array of string

Email addresses that receive the spend alert notification.

type: "email"

The notification channel type. Currently only email is supported.

subject_prefix: optional string

Optional subject prefix for alert emails.

object: "organization.spend_alert"

The object type, which is always organization.spend_alert.

threshold_amount: number

The alert threshold amount, in cents.

organization_spend_alert_deleted: object { id, deleted, object }

Confirmation payload returned after deleting an organization spend alert.

id: string

The deleted spend alert ID.

deleted: boolean

Whether the spend alert was deleted.

object: "organization.spend_alert.deleted"

Always organization.spend_alert.deleted.