Skip to content
Primary navigation

Suggested
API Dashboard
API Reference
Admin
Organization
Spend Alerts

Update organization spend alert

client.Admin.Organization.SpendAlerts.Update(ctx, alertID, body) (*OrganizationSpendAlert, error)
POST/organization/spend_alerts/{alert_id}

Updates an organization spend alert.

ParametersExpand Collapse
alertID string
body AdminOrganizationSpendAlertUpdateParams
Currency param.Field[AdminOrganizationSpendAlertUpdateParamsCurrency]

The currency for the threshold amount.

const AdminOrganizationSpendAlertUpdateParamsCurrencyUsd AdminOrganizationSpendAlertUpdateParamsCurrency = "USD"
Interval param.Field[AdminOrganizationSpendAlertUpdateParamsInterval]

The time interval for evaluating spend against the threshold.

const AdminOrganizationSpendAlertUpdateParamsIntervalMonth AdminOrganizationSpendAlertUpdateParamsInterval = "month"
NotificationChannel param.Field[AdminOrganizationSpendAlertUpdateParamsNotificationChannel]

Email notification settings for a spend alert.

Recipients []string

Email addresses that receive the spend alert notification.

Type Email

The notification channel type. Currently only email is supported.

SubjectPrefix stringOptional

Optional subject prefix for alert emails.

ThresholdAmount param.Field[int64]

The alert threshold amount, in cents.

minimum0
ReturnsExpand Collapse
type OrganizationSpendAlert struct{…}

Represents a spend alert configured at the organization level.

ID string

The identifier, which can be referenced in API endpoints.

Currency OrganizationSpendAlertCurrency

The currency for the threshold amount.

Interval OrganizationSpendAlertInterval

The time interval for evaluating spend against the threshold.

NotificationChannel OrganizationSpendAlertNotificationChannel

Email notification settings for a spend alert.

Recipients []string

Email addresses that receive the spend alert notification.

Type Email

The notification channel type. Currently only email is supported.

SubjectPrefix stringOptional

Optional subject prefix for alert emails.

Object OrganizationSpendAlert

The object type, which is always organization.spend_alert.

ThresholdAmount int64

The alert threshold amount, in cents.

Update organization spend alert

package main

import (
  "context"
  "fmt"

  "github.com/openai/openai-go"
  "github.com/openai/openai-go/option"
)

func main() {
  client := openai.NewClient(
    option.WithAdminAPIKey("My Admin API Key"),
  )
  organizationSpendAlert, err := client.Admin.Organization.SpendAlerts.Update(
    context.TODO(),
    "alert_id",
    openai.AdminOrganizationSpendAlertUpdateParams{
      Currency: openai.AdminOrganizationSpendAlertUpdateParamsCurrencyUsd,
      Interval: openai.AdminOrganizationSpendAlertUpdateParamsIntervalMonth,
      NotificationChannel: openai.AdminOrganizationSpendAlertUpdateParamsNotificationChannel{
        Recipients: []string{"string"},
      },
      ThresholdAmount: 0,
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", organizationSpendAlert.ID)
}

{
    "id": "alert_abc123",
    "object": "organization.spend_alert",
    "threshold_amount": 150000,
    "currency": "USD",
    "interval": "month",
    "notification_channel": {
        "type": "email",
        "recipients": ["finance@example.com"],
        "subject_prefix": "OpenAI spend alert"
    }
}
Returns Examples
{
    "id": "alert_abc123",
    "object": "organization.spend_alert",
    "threshold_amount": 150000,
    "currency": "USD",
    "interval": "month",
    "notification_channel": {
        "type": "email",
        "recipients": ["finance@example.com"],
        "subject_prefix": "OpenAI spend alert"
    }
}