---
title: "Changes to Preview subscription modification"
method: POST
path: "/subscriptions/{id}/modify/preview"
---

# Changes to Preview subscription modification

`POST /subscriptions/{id}/modify/preview`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 13 revisions.

- **2026-06-29** `cef2964c102c`: 3 warning, 34 info
- **2026-05-18** `f62d8a5fe7cf`: 6 warning, 1 info
- **2026-05-18** `0cb3425d6580`: 1 info

## Changes

- **2026-06-29** `cef2964c102c`: 3 warning, 34 info
  - removed the optional property `changed_resources/invoices/items/invoice/subscription/customer_timezone` from the response with the `200` status
  - removed the optional property `subscription/customer_timezone` from the response with the `200` status
  - added the new `VOIDED` enum value to the `changed_resources/invoices/items/invoice/payment_status` response property for the response status `200`
  - added the new optional request property `coupon_params`
  - added the new optional request property `inheritance_params/action`
  - added the new optional request property `inheritance_params/external_customer_ids_to_remove`
  - added the new optional request property `tax_params`
  - added the new optional request property `trial_end_params`
  - added the new `coupon` enum value to the request property `type`
  - added the new `tax` enum value to the request property `type`
  - added the new `trial_end` enum value to the request property `type`
  - added the optional property `changed_resources/invoices/items/invoice/customer/integrations/items/metadata` to the response with the `200` status
  - added the optional property `changed_resources/invoices/items/invoice/customer/timezone` to the response with the `200` status
  - added the optional property `changed_resources/invoices/items/invoice/line_items/items/adjusted_entitlement_quantity` to the response with the `200` status
  - added the optional property `changed_resources/invoices/items/invoice/line_items/items/subscription_line_item_id` to the response with the `200` status
  - added the optional property `changed_resources/invoices/items/invoice/subscription/coupon_associations/items/coupon/coupon_code` to the response with the `200` status
  - added the optional property `changed_resources/invoices/items/invoice/subscription/coupon_associations/items/subscription_line_item` to the response with the `200` status
  - added the optional property `changed_resources/invoices/items/invoice/subscription/customer/integrations/items/metadata` to the response with the `200` status
  - added the optional property `changed_resources/invoices/items/invoice/subscription/customer/timezone` to the response with the `200` status
  - added the optional property `changed_resources/invoices/items/invoice/subscription/line_items/items/commitment_time_buckets` to the response with the `200` status
  - added the optional property `changed_resources/invoices/items/invoice/subscription/line_items/items/price/sequence` to the response with the `200` status
  - added the optional property `changed_resources/invoices/items/invoice/subscription/synced_price_sequence` to the response with the `200` status
  - added the optional property `changed_resources/invoices/items/invoice/subscription/timezone` to the response with the `200` status
  - added the optional property `changed_resources/invoices/items/wallet_transaction/created_by_user/metadata` to the response with the `200` status
  - added the optional property `changed_resources/invoices/items/wallet_transaction/created_by_user/name` to the response with the `200` status
  - added the optional property `changed_resources/invoices/items/wallet_transaction/customer/integrations/items/metadata` to the response with the `200` status
  - added the optional property `changed_resources/invoices/items/wallet_transaction/customer/timezone` to the response with the `200` status
  - added the optional property `changed_resources/subscriptions/items/current_period_end` to the response with the `200` status
  - added the optional property `changed_resources/subscriptions/items/trial_end` to the response with the `200` status
  - added the optional property `subscription/coupon_associations/items/coupon/coupon_code` to the response with the `200` status
  - added the optional property `subscription/coupon_associations/items/subscription_line_item` to the response with the `200` status
  - added the optional property `subscription/customer/integrations/items/metadata` to the response with the `200` status
  - added the optional property `subscription/customer/timezone` to the response with the `200` status
  - added the optional property `subscription/line_items/items/commitment_time_buckets` to the response with the `200` status
  - added the optional property `subscription/line_items/items/price/sequence` to the response with the `200` status
  - added the optional property `subscription/synced_price_sequence` to the response with the `200` status
  - added the optional property `subscription/timezone` to the response with the `200` status
- **2026-05-18** `f62d8a5fe7cf`: 6 warning, 1 info
  - removed the optional property `details` from the response with the `400` status
  - removed the optional property `details` from the response with the `404` status
  - removed the optional property `details` from the response with the `500` status
  - 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 `404`
  - added the new `too_many_requests` enum value to the `code` response property for the response status `500`
  - added the optional property `changed_resources/invoices/items/invoice/issue_date` to the response with the `200` status
- **2026-05-18** `0cb3425d6580`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/flexprice/apis/flexprice-api-2/docs/subscriptions/:id/modify/preview/post.md) - [API](https://skmtc.dev/flexprice/apis/flexprice-api-2.md) - [Page](https://skmtc.dev/flexprice/apis/flexprice-api-2/changes/subscriptions/:id/modify/preview/post)