# Update an organization's billing profile (internal)

**PATCH /admin/orgs/{orgId}/billing-profile**

Changes the tier, billing mode, billing email, card-on-file flag, charge trigger or price overrides of an organization already on case billing. Only the fields sent change; overrides merge into the existing ones, and a `null` SKU price removes that override. Returns the saved profile with warnings, for example when an override will bill a SKU the tier normally includes. Returns 404 when the organization has no billing profile and 400 for an invalid tier, mode and cadence combination or any change of cadence. Super admin only.


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Access token


## Parameters

### Path parameters

- **orgId** (string)
  Id of the organization



### Body: application/json (object)

- **tier** (string)

- **billingMode** (string)

- **cadence** (string)

- **billingEmail** (string)

- **paymentMethodOnFile** (boolean)

- **chargeTrigger** (string | null)
  When this org's phone collections are charged. `null` clears the override and returns the org to the platform-wide flag; `import` PINS it to import-time charging even after that flag flips.

- **overrides** (object)

- **reason** (string)
  Required audit reason — persisted on the BillingEvent



## Responses
### 200


#### Body: application/json (object)
- **data** (object)

- **statusCode** (number)

- **timestamp** (string(date-time))



[Powered by Bump.sh](https://bump.sh)