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

# Changes to Update a subscription

`PATCH /subscriptions/{subscription_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 12 of 19 revisions.

- **2026-10-19** (v1) `4f35a8c6ea4d`: 4 breaking, 5 info
- **2026-07-09** (v1) `e1ac347eb3c5`: 6 warning, 15 info
- **2026-02-02** (v1) `9ba8be0f2006`: 80 breaking, 31 warning, 137 info
- **2025-05-27** (v1) `e57c515077cc`: 1 breaking, 1 info
- **2025-04-25** (v1) `c4b1322e66ca`: 2 breaking, 4 info
- **2025-03-07** (v1) `a3359d7731fd`: 16 breaking, 4 info
- **2024-12-19** (v1) `6be8d2a4c7e1`: 2 breaking
- **2024-12-06** (v1) `274e5b2be190`: 462 breaking, 3 warning, 236 info
- **2024-08-06** (v1) `968e505782d4`: 1 info
- **2024-07-05** (v1) `8f7044f788af`: 1 info
- **2024-05-14** (v1) `61fe84bfd516`: 8 breaking, 2 warning, 8 info
- **2024-02-19** (v1) `a4a4068ff792`: 56 breaking, 11 warning, 26 info

## Changes

- **2026-10-19** (v1) `4f35a8c6ea4d`: 4 breaking, 5 info
  - removed `#/components/schemas/Duration` from the `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/trial_period` request property `anyOf` list
  - removed `#/components/schemas/Duration` from the `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/trial_period` request property `anyOf` list
  - added `#/components/schemas/CountryCodeNonSupported` to the `data/items/items/price/allOf[subschema #1: Price]/trial_period/anyOf[subschema #1: Price Trial Duration]/unit_price_overrides/items/country_codes/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/CountryCodeNonSupported` to the `data/items/items/price/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PriceTrialDurationCreate` to the `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/trial_period` request property `anyOf` list
  - added `#/components/schemas/PriceTrialDurationCreate` to the `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/trial_period` request property `anyOf` list
  - added `#/components/schemas/CountryCodeNonSupported` to the `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price_overrides/items/country_codes/items/` request property `oneOf` list
  - added `#/components/schemas/CountryCodeNonSupported` to the `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price_overrides/items/country_codes/items/` request property `oneOf` list
  - added the required property `data/management_urls/allOf[subschema #1: Subscription Management Urls]/view_subscription` to the response with the `200` status
- **2026-07-09** (v1) `e1ac347eb3c5`: 6 warning, 15 info
  - added the new `CLP` enum value to the `data/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200`
  - added the new `CLP` enum value to the `data/items/items/price/allOf[subschema #1: Price]/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `200`
  - added the new `CLP` enum value to the `data/items/items/price/allOf[subschema #1: Price]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `200`
  - added the new `PEN` enum value to the `data/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200`
  - added the new `PEN` enum value to the `data/items/items/price/allOf[subschema #1: Price]/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `200`
  - added the new `PEN` enum value to the `data/items/items/price/allOf[subschema #1: Price]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `200`
  - added the new `CLP` enum value to the request property `currency_code/allOf[subschema #1: Currency code]/`
  - added the new `CLP` enum value to the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `PEN` enum value to the request property `currency_code/allOf[subschema #1: Currency code]/`
  - added the new `PEN` enum value to the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `PEN` enum value to the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `PEN` enum value to the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `PEN` enum value to the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the optional property `data/items/items/price/allOf[subschema #1: Price]/trial_period/anyOf[subschema #1: Price Trial Duration]/unit_price` to the response with the `200` status
  - added the optional property `data/items/items/price/allOf[subschema #1: Price]/trial_period/anyOf[subschema #1: Price Trial Duration]/unit_price_overrides` to the response with the `200` status
  - added `#/components/schemas/SubscriptionDiscount` to the `data/discount` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/DiscountSubscription` from the `data/discount` response property `anyOf` list for the response status `200`
  - added the required property `data/consent_requirements` to the response with the `200` status
- **2026-02-02** (v1) `9ba8be0f2006`: 80 breaking, 31 warning, 137 info
  - added the new path request parameter `subscription_id`
  - request body became required
  - added `#/components/schemas/AddressId` to the `address_id` request property `allOf` list
  - added `#/components/schemas/CollectionMode` to the `collection_mode` request property `allOf` list
  - added `#/components/schemas/CurrencyCode` to the `currency_code` request property `allOf` list
  - added `#/components/schemas/CustomerId` to the `customer_id` request property `allOf` list
  - added `#/components/schemas/SubscriptionOnPaymentFailure` to the `on_payment_failure` request property `allOf` list
  - added `#/components/schemas/Timestamp` to the `next_billed_at` request property `allOf` list
  - the request property `discount` became not nullable
  - removed the enum value `ARS` of the request property `currency_code`
  - removed the enum value `AUD` of the request property `currency_code`
  - removed the enum value `BRL` of the request property `currency_code`
  - removed the enum value `CAD` of the request property `currency_code`
  - removed the enum value `CHF` of the request property `currency_code`
  - removed the enum value `CNY` of the request property `currency_code`
  - removed the enum value `COP` of the request property `currency_code`
  - removed the enum value `CZK` of the request property `currency_code`
  - removed the enum value `DKK` of the request property `currency_code`
  - removed the enum value `EUR` of the request property `currency_code`
  - removed the enum value `GBP` of the request property `currency_code`
  - removed the enum value `HKD` of the request property `currency_code`
  - removed the enum value `HUF` of the request property `currency_code`
  - removed the enum value `ILS` of the request property `currency_code`
  - removed the enum value `INR` of the request property `currency_code`
  - removed the enum value `JPY` of the request property `currency_code`
  - removed the enum value `KRW` of the request property `currency_code`
  - removed the enum value `MXN` of the request property `currency_code`
  - removed the enum value `NOK` of the request property `currency_code`
  - removed the enum value `NZD` of the request property `currency_code`
  - removed the enum value `PLN` of the request property `currency_code`
  - removed the enum value `RUB` of the request property `currency_code`
  - removed the enum value `SEK` of the request property `currency_code`
  - removed the enum value `SGD` of the request property `currency_code`
  - removed the enum value `THB` of the request property `currency_code`
  - removed the enum value `TRY` of the request property `currency_code`
  - removed the enum value `TWD` of the request property `currency_code`
  - removed the enum value `UAH` of the request property `currency_code`
  - removed the enum value `USD` of the request property `currency_code`
  - removed the enum value `VND` of the request property `currency_code`
  - removed the enum value `ZAR` of the request property `currency_code`
  - …208 more
- **2025-05-27** (v1) `e57c515077cc`: 1 breaking, 1 info
  - added `#/components/schemas/import_meta_subscription` to the `data/import_meta` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/import_meta` from the `data/import_meta` response property `oneOf` list for the response status `200`
- **2025-04-25** (v1) `c4b1322e66ca`: 2 breaking, 4 info
  - the `data/items/items/price/description` response property's maxLength was increased from `200` to `500` for the response status `200`
  - the `data/items/items/price/name` response property's maxLength was increased from `50` to `150` for the response status `200`
  - the `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/description` request property's maxLength was increased from `200` to `500`
  - the `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/name` request property's maxLength was increased from `50` to `150`
  - the `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/description` request property's maxLength was increased from `200` to `500`
  - the `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/name` request property's maxLength was increased from `50` to `150`
- **2025-03-07** (v1) `a3359d7731fd`: 16 breaking, 4 info
  - the `data/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's maxLength was unset from `200` for the response status `200`
  - the `data/items/items/price/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's maxLength was unset from `200` for the response status `200`
  - the `data/items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's maxLength was unset from `200` for the response status `200`
  - the `data/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `data/items/items/price/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `data/items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's minLength was decreased from `1` to `0` for the response status `200`
  - added `#/components/schemas/external_id, subschema #2` to the `data/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/external_id, subschema #2` to the `data/items/items/price/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/external_id, subschema #2` to the `data/items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/migration_provider_public` to the `data/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/migration_provider_public` to the `data/items/items/price/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/migration_provider_public` to the `data/items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/price_trial_duration` to the `data/items/items/price/trial_period` response property `oneOf` list for the response status `200`
  - the `data/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response's property type changed from `string, null` to no type for status `200`
  - the `data/items/items/price/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response's property type changed from `string, null` to no type for status `200`
  - the `data/items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response's property type changed from `string, null` to no type for status `200`
  - removed `#/components/schemas/duration` from the `data/items/items/price/trial_period` response property `oneOf` list for the response status `200`
  - the response required property `data/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `200`
  - the response required property `data/items/items/price/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `200`
  - the response required property `data/items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `200`
- **2024-12-19** (v1) `6be8d2a4c7e1`: 2 breaking
  - added `#/components/schemas/timestamp, subschema #2` to the `data/discount/oneOf[subschema #1: SubscriptionDiscountTimePeriod]/starts_at` response property `oneOf` list for the response status `200`
  - the `data/discount/oneOf[subschema #1: SubscriptionDiscountTimePeriod]/starts_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `200`
- **2024-12-06** (v1) `274e5b2be190`: 462 breaking, 3 warning, 236 info
  - removed the enum value `AD` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AD` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AE` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AE` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AG` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AG` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AI` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AI` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AL` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AL` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AM` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AM` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AO` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AO` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AR` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AR` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AS` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AS` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AT` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AT` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AU` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AU` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AW` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AW` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AX` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AX` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AZ` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AZ` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BA` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BA` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BB` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BB` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BD` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BD` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BE` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BE` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BF` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BF` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BG` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BG` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/`
  - …661 more
- **2024-08-06** (v1) `968e505782d4`: 1 info
  - added `#/components/schemas/subscription_item_create_with_price, #/components/schemas/subscription_item_create_with_price_and_product` to the `items/items/` request property `oneOf` list
- **2024-07-05** (v1) `8f7044f788af`: 1 info
  - added the optional property `data/items/items/product` to the response with the `200` status
- **2024-05-14** (v1) `61fe84bfd516`: 8 breaking, 2 warning, 8 info
  - request property `on_payment_failure` was restricted to a list of enum values
  - removed `#/components/schemas/subscription_on_payment_failure, subschema #2` from the `on_payment_failure` request property `oneOf` list
  - the `items/items/` request property type changed from `object` to no type
  - the `on_payment_failure` request property type changed from no type to `string`
  - added `#/components/schemas/duration` to the `data/items/items/price/billing_cycle` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/duration` to the `data/items/items/price/trial_period` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/timestamp, subschema #2` to the `data/discount/oneOf[subschema #1: Subscription discount]/ends_at` response property `oneOf` list for the response status `200`
  - the `data/discount/oneOf[subschema #1: Subscription discount]/ends_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `200`
  - removed the request property `items/items/price_id`
  - removed the request property `items/items/quantity`
  - the `on_payment_failure` request property default value `prevent_change` was added
  - added the new `apply_change` enum value to the request property `on_payment_failure`
  - added the new `prevent_change` enum value to the request property `on_payment_failure`
  - added `#/components/schemas/subscription_update_item` to the `items/items/` request property `oneOf` list
  - added the optional property `data/items/items/price/created_at` to the response with the `200` status
  - added the optional property `data/items/items/price/updated_at` to the response with the `200` status
  - removed `#/components/schemas/period` from the `data/items/items/price/billing_cycle` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/period` from the `data/items/items/price/trial_period` response property `oneOf` list for the response status `200`
- **2024-02-19** (v1) `a4a4068ff792`: 56 breaking, 11 warning, 26 info
  - the request property `billing_details` became not nullable
  - the request property `business_id` became not nullable
  - the request property `custom_data` became not nullable
  - removed the enum value `apply_change` of the request property `on_payment_failure`
  - removed the enum value `prevent_change` of the request property `on_payment_failure`
  - the `billing_details` request property type changed from `object, null` to no type
  - the `business_id` request property type changed from `string, null` to no type
  - the `custom_data` request property type changed from `object, null` to no type
  - the `on_payment_failure` request property type changed from `string` to no type
  - added `#/components/schemas/billing_details, subschema #2` to the `data/billing_details` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/business_id, subschema #2` to the `data/business_id` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/custom_data, subschema #2` to the `data/custom_data` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/discount-subscription, subschema #2` to the `data/discount` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/import_meta, subschema #2` to the `data/import_meta` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/period, subschema #2` to the `data/items/items/price/billing_cycle` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/period, subschema #2` to the `data/items/items/price/trial_period` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/subscription_scheduled_change, subschema #2` to the `data/scheduled_change` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/time_period, subschema #2` to the `data/current_billing_period` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/time_period, subschema #2` to the `data/items/items/trial_dates` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/timestamp, subschema #2` to the `data/canceled_at` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/timestamp, subschema #2` to the `data/first_billed_at` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/timestamp, subschema #2` to the `data/items/items/next_billed_at` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/timestamp, subschema #2` to the `data/items/items/previously_billed_at` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/timestamp, subschema #2` to the `data/next_billed_at` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/timestamp, subschema #2` to the `data/paused_at` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/timestamp, subschema #2` to the `data/started_at` response property `oneOf` list for the response status `200`
  - the `data/billing_details` response's property type changed from `object, null` to no type for status `200`
  - the `data/business_id` response's property type changed from `string, null` to no type for status `200`
  - the `data/canceled_at` response's property type changed from `string, null` to no type, and format from `date-time` to no format for status `200`
  - the `data/current_billing_period` response's property type changed from `object, null` to no type for status `200`
  - the `data/custom_data` response's property type changed from `object, null` to no type for status `200`
  - the `data/discount` response's property type changed from `object, null` to no type for status `200`
  - the `data/first_billed_at` response's property type changed from `string, null` to no type, and format from `date-time` to no format for status `200`
  - the `data/import_meta` response's property type changed from `object, null` to no type for status `200`
  - the `data/items/items/next_billed_at` response's property type changed from `string, null` to no type, and format from `date-time` to no format for status `200`
  - the `data/items/items/previously_billed_at` response's property type changed from `string, null` to no type, and format from `date-time` to no format for status `200`
  - the `data/items/items/price/billing_cycle` response's property type changed from `object, null` to no type for status `200`
  - the `data/items/items/price/trial_period` response's property type changed from `object, null` to no type for status `200`
  - the `data/items/items/trial_dates` response's property type changed from `object, null` to no type for status `200`
  - the `data/next_billed_at` response's property type changed from `string, null` to no type, and format from `date-time` to no format for status `200`
  - …53 more

---

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