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

# Changes to Update Subscription

`PUT /subscriptions/{subscription_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 27 revisions.

- **2026-10-10** `4eb2502fcc00`: 1 info
- **2026-09-05** `1d6b546b10f2`: 1 info
- **2026-09-02** `156f17ff484d`: 1 breaking, 1 info
- **2026-08-25** `9db82db717c5`: 5 breaking
- **2026-08-22** `7919e33b4853`: 1 breaking, 1 info

## Changes

- **2026-10-10** `4eb2502fcc00`: 1 info
  - added the optional property `end_subscription_at` to the response with the `200` status
- **2026-09-05** `1d6b546b10f2`: 1 info
  - added the optional property `has_usage_based_plan` to the response with the `200` status
- **2026-09-02** `156f17ff484d`: 1 breaking, 1 info
  - removed `#/components/schemas/updateSubscription, #/components/schemas/updateSubscriptionNewPlan` from the request body `oneOf` list
  - added `#/components/schemas/updateSubscription, #/components/schemas/updateSubscriptionBillingCycleDay, #/components/schemas/updateSubscriptionNewPlan` to the request body `anyOf` list
- **2026-08-25** `9db82db717c5`: 5 breaking
  - the response property `expires_at` became nullable for the status `200`
  - the response property `subscription_details/discount_phase_details` became nullable for the status `200`
  - the response property `subscription_details/trial_details` became nullable for the status `200`
  - the response property `subscription_plan_id` became nullable for the status `200`
  - the response property `total_billing_intervals` became nullable for the status `200`
- **2026-08-22** `7919e33b4853`: 1 breaking, 1 info
  - the response property `nickname` became nullable for the status `200`
  - the request property `oneOf[subschema #1: Update Subscription]/nickname` became nullable

---

[Operation](https://skmtc.dev/finix/apis/finix-api-reference/docs/subscriptions/:subscription_id/put.md) - [API](https://skmtc.dev/finix/apis/finix-api-reference.md) - [Page](https://skmtc.dev/finix/apis/finix-api-reference/changes/subscriptions/:subscription_id/put)