---
title: "Changes to Update Subscription"
method: PUT
path: "/api/v2/subscriptions/{subscription_id}"
---

# Changes to Update Subscription

`PUT /api/v2/subscriptions/{subscription_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 16 revisions.

- **2026-11-05** `9c73cbd109e4`: 1 warning, 9 info
- **2026-10-09** `dfac786362d9`: 2 warning, 6 info
- **2026-09-15** `85261606a8ea`: 1 info
- **2026-09-07** `7269a6d9677f`: 3 info
- **2026-09-03** `515eeea7d260`: 4 warning, 21 info
- **2026-07-15** `9a960de24945`: 1 breaking, 3 warning, 15 info

## Changes

- **2026-11-05** `9c73cbd109e4`: 1 warning, 9 info
  - removed the request property `exclude_coupons_if_installments`
  - added the optional property `created_by_id` to the response with the `200` status
  - added the optional property `created_by_type` to the response with the `200` status
  - added the optional property `items/items/product/created_by_id` to the response with the `200` status
  - added the optional property `items/items/product/created_by_type` to the response with the `200` status
  - added the optional property `items/items/product/organization_id` to the response with the `200` status
  - added the optional property `latest_freeze/created_by_id` to the response with the `200` status
  - added the optional property `latest_freeze/created_by_type` to the response with the `200` status
  - added the optional property `latest_freeze/organization_id` to the response with the `200` status
  - added the optional property `organization_id` to the response with the `200` status
- **2026-10-09** `dfac786362d9`: 2 warning, 6 info
  - removed the optional property `items/items/product/external_id` from the response with the `200` status
  - removed the optional property `latest_invoice/external_id` from the response with the `200` status
  - added the optional property `items/items/product/accounting_external_id` to the response with the `200` status
  - added the optional property `latest_invoice/accounting_external_id` to the response with the `200` status
  - added the optional property `organization_consumer/address/building_number` to the response with the `200` status
  - added the optional property `organization_consumer/address/district` to the response with the `200` status
  - added the optional property `organization_consumer/address/street` to the response with the `200` status
  - the response optional property `organization_consumer/address/address_line_1` became read-only for the status `200`
- **2026-09-15** `85261606a8ea`: 1 info
  - added the optional property `latest_invoice/installment_rule_override_id` to the response with the `200` status
- **2026-09-07** `7269a6d9677f`: 3 info
  - added the optional property `items/items/product/external_id` to the response with the `200` status
  - added the optional property `latest_invoice/external_id` to the response with the `200` status
  - added the optional property `latest_invoice/installments_start_date` to the response with the `200` status
- **2026-09-03** `515eeea7d260`: 4 warning, 21 info
  - added the new `METERED` enum value to the `items/items/product/type` response property for the response status `200`
  - added the new `XAD` enum value to the `items/items/product/currency` response property for the response status `200`
  - added the new `XCG` enum value to the `items/items/product/currency` response property for the response status `200`
  - added the new `ZWG` enum value to the `items/items/product/currency` response property for the response status `200`
  - added the optional property `beneficiaries/items/fields` to the response with the `200` status
  - added the optional property `latest_invoice/metered_subscription_id` to the response with the `200` status
  - added the optional property `latest_invoice/no_of_payments` to the response with the `200` status
  - response property `items/items/product/is_price_inclusive_of_vat` deprecated
  - response property `items/items/product/price_excluding_vat` deprecated
  - response property `items/items/product/prices/items/is_price_inclusive_of_vat` deprecated
  - response property `items/items/product/prices/items/price_excluding_vat` deprecated
  - response property `items/items/product/prices/items/vat_amount` deprecated
  - response property `items/items/product/vat_amount` deprecated
  - removed the `ANG` enum value from the `items/items/product/currency` response property for the response status `200`
  - removed the `BGN` enum value from the `items/items/product/currency` response property for the response status `200`
  - removed the `CUC` enum value from the `items/items/product/currency` response property for the response status `200`
  - removed the `HRK` enum value from the `items/items/product/currency` response property for the response status `200`
  - removed the `SLL` enum value from the `items/items/product/currency` response property for the response status `200`
  - removed the `ZWL` enum value from the `items/items/product/currency` response property for the response status `200`
  - the `items/items/product/price` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`
  - the `items/items/product/price_excluding_vat` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`
  - the `items/items/product/prices/items/amount` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`
  - the `items/items/product/prices/items/price_excluding_vat` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`
  - the `items/items/product/prices/items/vat_amount` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`
  - the `items/items/product/vat_amount` response's property pattern `^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$` was removed for the status `200`
- **2026-07-15** `9a960de24945`: 1 breaking, 3 warning, 15 info
  - the `items/items/product/description` response property's maxLength was increased from `500` to `512` for the response status `200`
  - added the new `PRORATION` enum value to the `latest_invoice/type` response property for the response status `200`
  - added the new `TRIALING` enum value to the `status` response property for the response status `200`
  - added the new `TRIAL_PENDING` enum value to the `status` response property for the response status `200`
  - added the new optional request property `exclude_coupons_if_installments`
  - added the new optional request property `recurring_interval`
  - added the new optional request property `recurring_interval_count`
  - the `description` request property's maxLength was increased from `500` to `512`
  - added the optional property `beneficiaries` to the response with the `200` status
  - added the optional property `items/items/product/external_metadata` to the response with the `200` status
  - added the optional property `organization_consumer/address` to the response with the `200` status
  - added the optional property `organization_consumer/commercial_registration` to the response with the `200` status
  - added the optional property `organization_consumer/consumer_type` to the response with the `200` status
  - added the optional property `organization_consumer/phone_number` to the response with the `200` status
  - added the optional property `organization_consumer/preferred_language` to the response with the `200` status
  - added the optional property `organization_consumer/vat_number` to the response with the `200` status
  - added the optional property `pending_change` to the response with the `200` status
  - added the optional property `trial_end` to the response with the `200` status
  - added the optional property `trial_period_days` to the response with the `200` status

---

[Operation](https://skmtc.dev/streampay/apis/stream-app/docs/api/v2/subscriptions/:subscription_id/put.md) - [API](https://skmtc.dev/streampay/apis/stream-app.md) - [Page](https://skmtc.dev/streampay/apis/stream-app/changes/api/v2/subscriptions/:subscription_id/put)
