---
title: "Changes to Update a subscription"
method: PUT
path: "/subscriptions/{external_id}"
---

# Changes to Update a subscription

`PUT /subscriptions/{external_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 3 revisions.

- **2026-11-05** `b216574b9612`: 1 warning
- **2026-11-03** `5d26657495a3`: 23 breaking, 9 warning, 14 info

## Changes

- **2026-11-05** `b216574b9612`: 1 warning
  - removed the request property `subscription/plan_overrides/metadata`
- **2026-11-03** `5d26657495a3`: 23 breaking, 9 warning, 14 info
  - the `subscription` response's property type changed from `object` to no type for status `200`
  - removed the required property `subscription/billing_time` from the response with the `200` status
  - removed the required property `subscription/canceled_at` from the response with the `200` status
  - removed the required property `subscription/created_at` from the response with the `200` status
  - removed the required property `subscription/current_billing_period_ending_at` from the response with the `200` status
  - removed the required property `subscription/current_billing_period_started_at` from the response with the `200` status
  - removed the required property `subscription/downgrade_plan_date` from the response with the `200` status
  - removed the required property `subscription/ending_at` from the response with the `200` status
  - removed the required property `subscription/external_customer_id` from the response with the `200` status
  - removed the required property `subscription/external_id` from the response with the `200` status
  - removed the required property `subscription/lago_customer_id` from the response with the `200` status
  - removed the required property `subscription/lago_id` from the response with the `200` status
  - removed the required property `subscription/name` from the response with the `200` status
  - removed the required property `subscription/next_plan_code` from the response with the `200` status
  - removed the required property `subscription/on_termination_credit_note` from the response with the `200` status
  - removed the required property `subscription/on_termination_invoice` from the response with the `200` status
  - removed the required property `subscription/plan_code` from the response with the `200` status
  - removed the required property `subscription/previous_plan_code` from the response with the `200` status
  - removed the required property `subscription/started_at` from the response with the `200` status
  - removed the required property `subscription/status` from the response with the `200` status
  - removed the required property `subscription/subscription_at` from the response with the `200` status
  - removed the required property `subscription/terminated_at` from the response with the `200` status
  - removed the required property `subscription/trial_ended_at` from the response with the `200` status
  - removed the optional property `subscription/activated_at` from the response with the `200` status
  - removed the optional property `subscription/activation_rules` from the response with the `200` status
  - removed the optional property `subscription/applied_invoice_custom_sections` from the response with the `200` status
  - removed the optional property `subscription/billing_entity_code` from the response with the `200` status
  - removed the optional property `subscription/cancellation_reason` from the response with the `200` status
  - removed the optional property `subscription/consolidate_invoice` from the response with the `200` status
  - removed the optional property `subscription/payment_method` from the response with the `200` status
  - removed the optional property `subscription/plan_amount_cents` from the response with the `200` status
  - removed the optional property `subscription/plan_amount_currency` from the response with the `200` status
  - added the new optional request property `subscription/on_termination_credit_note`
  - added the new optional request property `subscription/on_termination_invoice`
  - added the new optional request property `subscription/plan_overrides/charges/items/applied_pricing_unit/code`
  - added the new optional request property `subscription/progressive_billing_disabled`
  - added the new optional request property `subscription/purchase_order_number`
  - added the new optional request property `subscription/usage_thresholds`
  - the request property `subscription/ending_at` became optional
  - request property `subscription/plan_overrides/usage_thresholds` deprecated
  - …6 more

---

[Operation](https://skmtc.dev/getlago/apis/lago-api-documentation/docs/subscriptions/:external_id/put.md) - [API](https://skmtc.dev/getlago/apis/lago-api-documentation.md) - [Page](https://skmtc.dev/getlago/apis/lago-api-documentation/changes/subscriptions/:external_id/put)