---
title: "Changes to Update a price"
method: PATCH
path: "/prices/{price_id}"
---

# Changes to Update a price

`PATCH /prices/{price_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 19 revisions.

- **2026-10-19** (v1) `4f35a8c6ea4d`: 2 breaking, 2 info
- **2026-07-09** (v1) `e1ac347eb3c5`: 1 breaking, 4 warning, 7 info
- **2026-02-02** (v1) `9ba8be0f2006`: 49 breaking, 7 warning, 55 info
- **2025-04-25** (v1) `c4b1322e66ca`: 2 breaking, 2 info
- **2025-03-07** (v1) `a3359d7731fd`: 6 breaking, 2 info
- **2024-12-06** (v1) `274e5b2be190`: 232 breaking, 2 warning, 232 info
- **2024-05-14** (v1) `61fe84bfd516`: 4 breaking, 6 info
- **2024-02-19** (v1) `a4a4068ff792`: 7 breaking, 1 warning, 5 info

## Changes

- **2026-10-19** (v1) `4f35a8c6ea4d`: 2 breaking, 2 info
  - added `#/components/schemas/CountryCodeNonSupported` to the `data/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/unit_price_overrides/items/country_codes/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/CountryCodeNonSupported` to the `trial_period/anyOf[subschema #1: Price Trial Duration]/unit_price_overrides/items/country_codes/items/` request property `oneOf` list
  - added `#/components/schemas/CountryCodeNonSupported` to the `unit_price_overrides/items/country_codes/items/` request property `oneOf` list
- **2026-07-09** (v1) `e1ac347eb3c5`: 1 breaking, 4 warning, 7 info
  - removed `#/components/schemas/Duration` from the `trial_period` request property `anyOf` list
  - added the new `CLP` enum value to the `data/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `200`
  - added the new `CLP` enum value to the `data/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/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `200`
  - added the new `PEN` enum value to the `data/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `200`
  - added `#/components/schemas/PriceTrialDurationUpdate` to the `trial_period` request property `anyOf` list
  - added the new `CLP` enum value to the request property `unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `CLP` enum value to the request property `unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `PEN` enum value to the request property `unit_price/allOf[subschema #1: Money]/currency_code`
  - added the new `PEN` enum value to the request property `unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code`
  - added the optional property `data/trial_period/anyOf[subschema #1: Price Trial Duration]/unit_price` to the response with the `200` status
  - added the optional property `data/trial_period/anyOf[subschema #1: Price Trial Duration]/unit_price_overrides` to the response with the `200` status
- **2026-02-02** (v1) `9ba8be0f2006`: 49 breaking, 7 warning, 55 info
  - added the new path request parameter `price_id`
  - request body became required
  - added `#/components/schemas/CatalogType` to the `type` request property `allOf` list
  - added `#/components/schemas/Money` to the `unit_price` request property `allOf` list
  - added `#/components/schemas/Money` to the `unit_price_overrides/items/unit_price` request property `allOf` list
  - added `#/components/schemas/PriceQuantity` to the `quantity` request property `allOf` list
  - added `#/components/schemas/TaxMode` to the `tax_mode` request property `allOf` list
  - the request property `name` became not nullable
  - removed the enum value `account_setting` of the request property `tax_mode`
  - removed the enum value `custom` of the request property `type`
  - removed the enum value `external` of the request property `tax_mode`
  - removed the enum value `internal` of the request property `tax_mode`
  - removed the enum value `standard` of the request property `type`
  - removed `#/components/schemas/country_code_supported` from the `unit_price_overrides/items/country_codes/items/` request property `oneOf` list
  - removed `#/components/schemas/custom_data, subschema #2` from the `custom_data` request property `oneOf` list
  - removed `#/components/schemas/duration, subschema #2` from the `billing_cycle` request property `oneOf` list
  - removed `#/components/schemas/duration, subschema #2` from the `trial_period` request property `oneOf` list
  - added the pattern `.*\S.*` to the request property `description`
  - the `name` request property type changed from `string, null` to no type
  - the `quantity` request property type changed from `object` to no type
  - the `tax_mode` request property type changed from `string` to no type
  - the `type` request property type changed from `string` to no type
  - the `unit_price` request property type changed from `object` to no type
  - the `unit_price_overrides/items/unit_price` request property type changed from `object` to no type
  - the `data/name` response property's maxLength was unset from `150` for the response status `200`
  - the `data/name` response property's minLength was decreased from `1` to `0` for the response status `200`
  - added `#/components/schemas/CountryCodeSupported` to the `data/unit_price_overrides/items/country_codes/items/` response property `oneOf` list for the response status `200`
  - the `data/created_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `200`
  - the `data/id` response's property type changed from `string` to no type for status `200`
  - the `data/name` response's property type changed from `string, null` to no type for status `200`
  - the `data/product_id` response's property type changed from `string` to no type for status `200`
  - the `data/quantity` response's property type changed from `object` to no type for status `200`
  - the `data/status` response's property type changed from `string` to no type for status `200`
  - the `data/tax_mode` response's property type changed from `string` to no type for status `200`
  - the `data/type` response's property type changed from `string` to no type for status `200`
  - the `data/unit_price` response's property type changed from `object` to no type for status `200`
  - the `data/unit_price_overrides/items/unit_price` response's property type changed from `object` to no type for status `200`
  - the `data/updated_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `200`
  - the `error` response's property type changed from `object` to no type for status `default`
  - removed the required property `data/quantity/maximum` from the response with the `200` status
  - …71 more
- **2025-04-25** (v1) `c4b1322e66ca`: 2 breaking, 2 info
  - the `data/description` response property's maxLength was increased from `200` to `500` for the response status `200`
  - the `data/name` response property's maxLength was increased from `50` to `150` for the response status `200`
  - the `description` request property's maxLength was increased from `200` to `500`
  - the `name` request property's maxLength was increased from `50` to `150`
- **2025-03-07** (v1) `a3359d7731fd`: 6 breaking, 2 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/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/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/price_trial_duration` to the `data/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`
  - removed `#/components/schemas/duration` from the `data/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`
- **2024-12-06** (v1) `274e5b2be190`: 232 breaking, 2 warning, 232 info
  - removed the enum value `AD` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AE` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AG` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AI` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AL` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AM` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AO` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AR` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AS` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AT` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AU` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AW` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AX` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `AZ` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BA` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BB` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BD` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BE` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BF` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BG` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BH` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BI` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BJ` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BL` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BM` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BN` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BO` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BQ` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BR` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BS` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BT` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BV` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BW` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `BZ` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `CA` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `CC` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `CG` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `CH` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `CI` of the request property `unit_price_overrides/items/country_codes/items/`
  - removed the enum value `CK` of the request property `unit_price_overrides/items/country_codes/items/`
  - …426 more
- **2024-05-14** (v1) `61fe84bfd516`: 4 breaking, 6 info
  - removed `#/components/schemas/period` from the `billing_cycle` request property `oneOf` list
  - removed `#/components/schemas/period` from the `trial_period` request property `oneOf` list
  - added `#/components/schemas/duration` to the `data/billing_cycle` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/duration` to the `data/trial_period` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/duration` to the `billing_cycle` request property `oneOf` list
  - added `#/components/schemas/duration` to the `trial_period` request property `oneOf` list
  - added the optional property `data/created_at` to the response with the `200` status
  - added the optional property `data/updated_at` to the response with the `200` status
  - removed `#/components/schemas/period` from the `data/billing_cycle` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/period` from the `data/trial_period` response property `oneOf` list for the response status `200`
- **2024-02-19** (v1) `a4a4068ff792`: 7 breaking, 1 warning, 5 info
  - the request property `custom_data` became not nullable
  - the `custom_data` request property type changed from `object, null` to no type
  - added `#/components/schemas/custom_data, subschema #2` to the `data/custom_data` 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`
  - the `data/custom_data` response's property type changed from `object, null` to no type for status `200`
  - the `data/import_meta` response's property type changed from `object, null` to no type for status `200`
  - removed the required property `data/import_meta/imported_from` from the response with the `200` status
  - removed the optional property `data/import_meta/external_id` from the response with the `200` status
  - added `#/components/schemas/custom_data, subschema #2` to the `custom_data` request property `oneOf` list
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `404`
  - removed the non-success response with the status `500`
  - the `status` response's property default value `active` was added for the status `200`

---

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