---
title: "Changes to UpdateBillingSubscription updates the billing plan for the organization"
method: PATCH
path: "/v1/orgs/{org}/billing/subscriptions"
---

# Changes to UpdateBillingSubscription updates the billing plan for the organization

`PATCH /v1/orgs/{org}/billing/subscriptions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 70 revisions.

- **2026-09-16** (v1) `ea2f8289f161`: 1 info
- **2026-06-29** (v1) `0d85409ea7c6`: 1 info
- **2026-06-19** (v1) `af47beb69889`: 1 info
- **2026-06-19** (v1) `045dfafc9e12`: 2 warning, 2 info
- **2026-04-13** (v1) `76877ddab8ec`: 2 warning
- **2025-12-12** (v1) `0928de6690f7`: 1 info

## Changes

- **2026-09-16** (v1) `ea2f8289f161`: 1 info
  - added the optional property `organization/defaultProvisioner` to the response with the `200` status
- **2026-06-29** (v1) `0d85409ea7c6`: 1 info
  - added the optional property `subscription/plan/quotas/tokensPerSeat` to the response with the `200` status
- **2026-06-19** (v1) `af47beb69889`: 1 info
  - added the optional property `organization/quotas/seats` to the response with the `200` status
- **2026-06-19** (v1) `045dfafc9e12`: 2 warning, 2 info
  - added the new `BILLING_PLAN_TYPE_GROWTH` enum value to the `subscription/plan/planType` response property for the response status `200`
  - added the new `BILLING_PLAN_TYPE_STARTER` enum value to the `subscription/plan/planType` response property for the response status `200`
  - added the optional property `subscription/plan/quotas/apiCallsPerSeat` to the response with the `200` status
  - added the optional property `subscription/plan/quotas/seats` to the response with the `200` status
- **2026-04-13** (v1) `76877ddab8ec`: 2 warning
  - added the new `BILLING_PLAN_TYPE_FREE` enum value to the `subscription/plan/planType` response property for the response status `200`
  - added the new `BILLING_PLAN_TYPE_PRO` enum value to the `subscription/plan/planType` response property for the response status `200`
- **2025-12-12** (v1) `0928de6690f7`: 1 info
  - added the optional property `organization/logoDarkUrl` to the response with the `200` status

---

[Operation](https://skmtc.dev/rilldata/apis/rill-admin-api/docs/v1/orgs/:org/billing/subscriptions/patch.md) - [API](https://skmtc.dev/rilldata/apis/rill-admin-api.md) - [Page](https://skmtc.dev/rilldata/apis/rill-admin-api/changes/v1/orgs/:org/billing/subscriptions/patch)