---
title: "Put Billing Settings"
method: PUT
path: "/v1/orgs/{org_id}/billing/settings"
tags: ["billing"]
---

# Put Billing Settings

`PUT /v1/orgs/{org_id}/billing/settings`

## Request

- Base URL: `https://api.sonenta.dev`
- URL: `https://api.sonenta.dev/v1/orgs/{org_id}/billing/settings`
- Auth: none declared

Update the org's billing settings. Validates the auto-topup pack SKU.

## Path parameters

- `org_id` string, required

## Request body

- BillingSettingsIn
  - `auto_topup` AutoTopupIn
    - `enabled` boolean
    - `threshold_credits` integer: auto-buy when balance drops below this
    - `pack` string, nullable: credit pack SKU to purchase
  - `alert_thresholds` AlertThresholdsIn
    - `cdn` number
    - `storage` number
    - `mcp` number
    - `credits` number
  - `storage_hard_cap` boolean

## Response `200`

Successful Response

- BillingSettingsOut
  - `auto_topup` AutoTopupIn
    - `enabled` boolean
    - `threshold_credits` integer: auto-buy when balance drops below this
    - `pack` string, nullable: credit pack SKU to purchase
  - `alert_thresholds` AlertThresholdsIn
    - `cdn` number
    - `storage` number
    - `mcp` number
    - `credits` number
  - `storage_hard_cap` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sonenta/apis/sonenta-api.md) · [All operations](https://skmtc.dev/sonenta/apis/sonenta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sonenta/apis/sonenta-api/revisions/f853ea49fb05?raw)