---
title: "Update billing alert configuration"
method: PATCH
path: "/organizations/{organization_id}/alerts/billing"
tags: ["Organization Management"]
---

# Update billing alert configuration

`PATCH /organizations/{organization_id}/alerts/billing`

Updates billing alert configuration for the specified organization.

## Path parameters

- `organization_id` string, required

## Request body

- object
  - `active` boolean — Whether the billing alert should be active or not.
  - `config` object — The configuration for billing alerts.
    - `threshold` integer — The amount after which a billing alert should be triggered.
    - `mode` string — The mode in which the alert is triggered.

## Response `200`

OK

- OrganizationAlertConfig — The alert configuration for an organization.
  - `id` string — Type of alert (e.g. "billing")
  - `active` boolean — Whether the billing alert should be active or not.
  - `alerts_sent` number — Number of alerts sent.
  - `last_alert_at` string, nullable — The datetime the alert was last sent.
  - `updated_at` string, nullable — The datetime the alert was last updated.
  - `config` object, nullable — Configuration for threshold and mode.
    - `threshold` object — Data regarding threshold spend.
      - `formatted` string — Formatted threshold value.
      - `amount` number — Threshold value.
      - `currency_code` string — Threshold currency code.
      - `currency_symbol` string — Threshold currency symbol.
    - `mode` string — The mode of alert.

## Other responses

- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/upsun/apis/upsun-com-rest-api.md) · [All operations](https://skmtc.net/upsun/apis/upsun-com-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upsun/upsun-com-rest-api/revisions/6cc88fde6435/schema)