---
title: "Changes to Update subscription"
method: PATCH
path: "/api/v1/subscriptions/{subscription_id}"
---

# Changes to Update subscription

`PATCH /api/v1/subscriptions/{subscription_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 54 revisions.

- **2026-08-12** (v1) `4e013b4e4a8f`: 16 breaking
- **2026-06-01** (v1) `07a61fe347a5`: 1 breaking, 1 warning
- **2026-05-28** (v1) `ed86d893d43e`: 1 breaking, 2 info
- **2026-05-18** (v1) `0cdc37620ffb`: 1 info
- **2026-03-31** (v1) `ee465c53a423`: 2 breaking, 5 info
- **2026-03-31** (v1) `560215310a09`: 2 breaking, 4 info
- **2026-03-27** (v1) `de35c02bb0d2`: 4 breaking, 4 warning, 2 info
- **2026-02-23** (v1) `e78cbe818dc6`: 2 info
- **2025-07-09** (v1) `dece17f86f99`: 1 breaking

## Changes

- **2026-08-12** (v1) `4e013b4e4a8f`: 16 breaking
  - the response property `subscription/add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became nullable for the status `200`
  - the response property `subscription/add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became nullable for the status `200`
  - the response property `subscription/add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became nullable for the status `200`
  - the response property `subscription/add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became nullable for the status `200`
  - the response property `subscription/components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became nullable for the status `200`
  - the response property `subscription/components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became nullable for the status `200`
  - the response property `subscription/components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became nullable for the status `200`
  - the response property `subscription/components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became nullable for the status `200`
  - the response property `subscription/add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became optional for the status `200`
  - the response property `subscription/add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became optional for the status `200`
  - the response property `subscription/add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became optional for the status `200`
  - the response property `subscription/add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became optional for the status `200`
  - the response property `subscription/components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became optional for the status `200`
  - the response property `subscription/components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became optional for the status `200`
  - the response property `subscription/components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became optional for the status `200`
  - the response property `subscription/components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became optional for the status `200`
- **2026-06-01** (v1) `07a61fe347a5`: 1 breaking, 1 warning
  - removed the required property `subscription/entitlements/items/value/oneOf[#/components/schemas/MeteredEntitlementValue]/overage_behavior` from the response with the `200` status
  - removed the optional property `subscription/entitlements/items/value/oneOf[#/components/schemas/MeteredEntitlementValue]/warning_threshold_pct` from the response with the `200` status
- **2026-05-28** (v1) `ed86d893d43e`: 1 breaking, 2 info
  - added `#/components/schemas/BooleanEntitlementValue, #/components/schemas/MeteredEntitlementValue` to the `subscription/entitlements/items/value` response property `oneOf` list for the response status `200`
  - added discriminator to `subscription/entitlements/items/value` response property for the response status `200`
  - removed `subschema #1, subschema #2` from the `subscription/entitlements/items/value` response property `oneOf` list for the response status `200`
- **2026-05-18** (v1) `0cdc37620ffb`: 1 info
  - added the optional property `subscription/entitlements` to the response with the `200` status
- **2026-03-31** (v1) `ee465c53a423`: 2 breaking, 5 info
  - the `subscription/applied_coupons/items/coupon/discount/oneOf[#/components/schemas/FixedDiscount]/amount` response's property format changed from `decimal` to no format for status `200`
  - the `subscription/applied_coupons/items/coupon/discount/oneOf[#/components/schemas/PercentageDiscount]/percentage` response's property format changed from `decimal` to no format for status `200`
  - response discriminator property name changed for `subscription/add_ons/items/fee` response property from `discriminator` to `type` for the response status `200`
  - response discriminator property name changed for `subscription/add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model` response property from `discriminator` to `type` for the response status `200`
  - response discriminator property name changed for `subscription/applied_coupons/items/coupon/discount` response property from `discriminator` to `type` for the response status `200`
  - response discriminator property name changed for `subscription/components/items/fee` response property from `discriminator` to `type` for the response status `200`
  - response discriminator property name changed for `subscription/components/items/fee/oneOf[#/components/schemas/UsageFee]/model` response property from `discriminator` to `type` for the response status `200`
- **2026-03-31** (v1) `560215310a09`: 2 breaking, 4 info
  - removed `subschema #1, subschema #2, subschema #3` from the `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` request property `oneOf` list
  - added `#/components/schemas/OnlinePaymentMethodConfig, #/components/schemas/BankTransferPaymentMethodConfig, #/components/schemas/ExternalPaymentMethodConfig` to the `subscription/payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` response property `oneOf` list for the response status `200`
  - added discriminator to `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` request property
  - added `#/components/schemas/OnlinePaymentMethodConfig, #/components/schemas/BankTransferPaymentMethodConfig, #/components/schemas/ExternalPaymentMethodConfig` to the `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` request property `oneOf` list
  - added discriminator to `subscription/payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` response property for the response status `200`
  - removed `subschema #1, subschema #2, subschema #3` from the `subscription/payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` response property `oneOf` list for the response status `200`
- **2026-03-27** (v1) `de35c02bb0d2`: 4 breaking, 4 warning, 2 info
  - the request property `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/oneOf[subschema #2]/account_id` became not nullable
  - the `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/oneOf[subschema #2]/account_id` request property type changed from `string, null` to no type
  - added `#/components/schemas/BankAccountId, subschema #1` to the `subscription/payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/oneOf[subschema #2]/account_id` response property `oneOf` list for the response status `200`
  - the `subscription/payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/oneOf[subschema #2]/account_id` response's property type changed from `string, null` to no type for status `200`
  - added the new `TOO_MANY_REQUESTS` enum value to the `code` response property for the response status `400`
  - added the new `TOO_MANY_REQUESTS` enum value to the `code` response property for the response status `401`
  - added the new `TOO_MANY_REQUESTS` enum value to the `code` response property for the response status `404`
  - added the new `TOO_MANY_REQUESTS` enum value to the `code` response property for the response status `500`
  - added `#/components/schemas/BankAccountId, subschema #1` to the `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/oneOf[subschema #2]/account_id` request property `oneOf` list
  - added the non-success response with the status `429`
- **2026-02-23** (v1) `e78cbe818dc6`: 2 info
  - added the optional property `subscription/add_ons/items/id` to the response with the `200` status
  - added the required property `subscription/add_ons/items/quantity` to the response with the `200` status
- **2025-07-09** (v1) `dece17f86f99`: 1 breaking
  - api removed without deprecation

---

[Operation](https://skmtc.dev/meteroid-oss/apis/meteroid/docs/api/v1/subscriptions/:subscription_id/patch.md) - [API](https://skmtc.dev/meteroid-oss/apis/meteroid.md) - [Page](https://skmtc.dev/meteroid-oss/apis/meteroid/changes/api/v1/subscriptions/:subscription_id/patch)