---
title: "Changes to Update Subscription Plan"
method: PUT
path: "/subscription_plans/{subscription_plan_id}"
---

# Changes to Update Subscription Plan

`PUT /subscription_plans/{subscription_plan_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 27 revisions.

- **2026-09-05** `1d6b546b10f2`: 1 info
- **2026-09-02** `156f17ff484d`: 1 breaking, 6 warning, 1 info
- **2026-08-25** `9db82db717c5`: 2 breaking, 1 info
- **2026-08-22** `7919e33b4853`: 1 breaking, 1 info

## Changes

- **2026-09-05** `1d6b546b10f2`: 1 info
  - added the optional property `billing_items` to the response with the `200` status
- **2026-09-02** `156f17ff484d`: 1 breaking, 6 warning, 1 info
  - the request's body type changed from `object` to no type
  - removed the request property `amount`
  - removed the request property `description`
  - removed the request property `nickname`
  - removed the request property `state`
  - removed the request property `tags`
  - removed the request property `update_existing_subscriptions`
  - added `#/components/schemas/updateSubscriptionPlan, #/components/schemas/deactivateSubscriptionPlan` to the request body `anyOf` list
- **2026-08-25** `9db82db717c5`: 2 breaking, 1 info
  - the response property `discount_phase_defaults` became nullable for the status `200`
  - the response property `trial_defaults` became nullable for the status `200`
  - added the optional property `is_usage_based` to the response with the `200` status
- **2026-08-22** `7919e33b4853`: 1 breaking, 1 info
  - the response property `nickname` became nullable for the status `200`
  - the request property `nickname` became nullable

---

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