# Update the organization's subscription plan

> PATCH /billing/plan

Source: https://docs.trykintsugi.com/reference/2026-07-21/update-the-organization-s-subscription-plan

PATCH /billing/plan

Update the organization's subscription plan

Moves the existing Chargebee subscription of the org selected by Organization-Id, Connection-Id, or Entity-Id to the given plan. Requires a subscription to already exist; use POST /billing/checkout for a first-time checkout.

Category: Billing

Request body:
billingPlan (PublicBillingWritePlanEnum, required) - Plan tier to update the existing subscription to.
  allowed values: GROWTH, PREMIUM

Response fields:
id (string, required) - Chargebee subscription id.
status (PublicSubscriptionStatusEnum, required) - Subscription status.
  allowed values: FUTURE, IN_TRIAL, ACTIVE, NON_RENEWING, PAUSED, CANCELLED, TRANSFERRED
currency (CurrencyEnum, required) - ISO-4217 currency for all amounts.
  allowed values: AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD (and 150 more, see the reference page)
billingPeriod (integer, required) - Length of one billing cycle.
billingPeriodUnit (string, required) - Unit for `billingPeriod`, e.g. `month` or `year`.
currentTermStart (string) - Start of the current billing term.
currentTermEnd (string) - End of the current billing term.
nextBillingAt (string) - When the next invoice is expected.
coupon (string) - Coupon code applied to the subscription, if any.
items (SubscriptionItem[], required) - Priced lines on the subscription.
  itemPriceId (string, required) - Chargebee item price id for this line.
  itemType (string, required) - Kind of line, e.g. `plan`, `addon`, or `charge`.
  quantity (integer) - Quantity, when metered.
  unitPrice (string, required) - Price per unit, in the subscription's currency.
  amount (string) - Total amount for this line, when set.

Response statuses: 200, 400, 401, 404, 422

---

Index of every page: https://docs.trykintsugi.com/llms.txt