---
title: "Update billing account"
method: PUT
path: "/billing_accounts/{id}"
tags: ["Billing"]
---

# Update billing account

`PUT /billing_accounts/{id}`

Updates the billing account information for the given ID.

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string
  - `detail` string

## Response `200`

Successfully updated billing account

- BillingManagerAccountAdmin — Internal billing account representation for project admins. Includes all fields including status.
  - `id` string, uuid — The unique identifier of the account.
  - `customer_id` string, uuid — The unique identifier of the associated customer. Returned from the `GET /customers` response.
  - `status` 'active' | 'frozen' | 'deleted' — The status of the billing account.
  - `name` string — The display name of the billing account.
  - `detail` string — A human-readable note describing the purpose of this account.
  - `plan_type` 'free' | 'basic' | 'professional' | 'unlimited' — The plan tier of the billing account. Determines resource creation limits.
  - `plan_status` 'active' | 'canceling' — The subscription plan status of the billing account. Indicates whether the plan is actively running or scheduled for cancellation.
  - `balance_credit` integer — The credit balance of the account in micros (1 USD = 1,000,000).
  - `balance_token` integer — The token balance of the account.
  - `payment_type` '' | 'prepaid' — The type of payment associated with the account.
  - `payment_method` '' | 'credit card' — The method of payment used for the account.
  - `paddle_subscription_id` string — The Paddle subscription identifier for this billing account.
  - `paddle_customer_id` string — The Paddle customer identifier for this billing account.
  - `tm_last_topup` string, date-time — The timestamp of the last token top-up.
  - `tm_next_topup` string, date-time — The timestamp of the next scheduled token top-up.
  - `tm_create` string, date-time — The timestamp when the account was created.
  - `tm_update` string, date-time — The timestamp when the account was last updated.
  - `tm_delete` string, date-time — The timestamp when the account was deleted, if applicable.

## Other responses

- `400` — Invalid request (INVALID_ARGUMENT).
- `401` — Authentication required (UNAUTHENTICATED).
- `403` — Insufficient permission (PERMISSION_DENIED).
- `404` — Resource not found (NOT_FOUND).
- `500` — Internal error (INTERNAL).

---

[API](https://skmtc.net/voipbin/apis/voipbin-api.md) · [All operations](https://skmtc.net/voipbin/apis/voipbin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voipbin/voipbin-api/versions/79e779080bcc/schema)