---
title: "Changes to Delete subscription line item"
method: DELETE
path: "/subscriptions/lineitems/{id}"
---

# Changes to Delete subscription line item

`DELETE /subscriptions/lineitems/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 20 of 139 revisions.

- **2026-09-01** `e1d4e27b5677`: 1 info
- **2026-08-24** `9cd0dab91f5c`: 1 info
- **2026-08-24** `66536658bde6`: 1 info
- **2026-08-21** `d567e8585c2e`: 1 warning
- **2026-08-21** `edf928b9b745`: 1 info
- **2026-07-31** `50b7421a9690`: 1 info
- **2026-07-15** `f8ecf435d25d`: 3 warning, 1 info
- **2026-07-09** `646d6658479b`: 1 info
- **2026-07-09** `7d57386313c7`: 25 breaking, 35 warning, 27 info
- **2026-07-09** `4b1a811c4179`: 47 breaking, 24 warning, 35 info
- **2026-06-16** `257509e66883`: 6 info
- **2026-06-10** `2a40f94de722`: 1 info
- **2026-06-03** `7adf4f33ea1a`: 1 info
- **2026-05-18** `8ec2edea6b20`: 4 warning
- **2026-04-25** `5cfd03c5fc75`: 1 warning
- **2026-04-23** `2ead4d5de7c1`: 2 warning, 2 info
- **2026-04-22** `147c5358b6c7`: 2 info
- **2026-04-10** `5856ed2fbdd6`: 3 warning, 1 info
- **2026-04-06** `95af41a12111`: 4 warning, 8 info
- **2026-03-02** `8ab89ff34fdc`: 1 info

## Changes

- **2026-09-01** `e1d4e27b5677`: 1 info
  - added the optional property `price/bucket_size` to the response with the `200` status
- **2026-08-24** `9cd0dab91f5c`: 1 info
  - added the optional property `price/plan/price_sync_status` to the response with the `200` status
- **2026-08-24** `66536658bde6`: 1 info
  - added the optional property `price/feature` to the response with the `200` status
- **2026-08-21** `d567e8585c2e`: 1 warning
  - removed the optional property `price/plan/price_sync_status` from the response with the `200` status
- **2026-08-21** `edf928b9b745`: 1 info
  - added the optional property `price/plan/price_sync_status` to the response with the `200` status
- **2026-07-31** `50b7421a9690`: 1 info
  - added the optional property `meter` to the response with the `200` status
- **2026-07-15** `f8ecf435d25d`: 3 warning, 1 info
  - added the new `ADDON` enum value to the `price/plan/credit_grants/items/scope` response property for the response status `200`
  - added the new `not_implemented` enum value to the `code` response property for the response status `400`
  - added the new `not_implemented` enum value to the `code` response property for the response status `500`
  - added the optional property `price/plan/credit_grants/items/addon_id` to the response with the `200` status
- **2026-07-09** `646d6658479b`: 1 info
  - the `billing_period_count` response's property default value `1` was removed for the status `200`
- **2026-07-09** `7d57386313c7`: 25 breaking, 35 warning, 27 info
  - request property `proration_behavior` was restricted to a list of enum values
  - the `proration_behavior` request property type changed from no type to `string`
  - the `commitment_time_buckets/items/` response's property type changed from no type to `object` for status `200`
  - the `entity_type` response's property type changed from no type to `string` for status `200`
  - the `invoice_cadence` response's property type changed from no type to `string` for status `200`
  - the `price/entity_type` response's property type changed from no type to `string` for status `200`
  - the `price/invoice_cadence` response's property type changed from no type to `string` for status `200`
  - the `price/metadata` response's property type changed from no type to `object` for status `200`
  - the `price/meter/aggregation` response's property type changed from no type to `object` for status `200`
  - the `price/meter/filters/items/` response's property type changed from no type to `object` for status `200`
  - the `price/meter/reset_usage` response's property type changed from no type to `string` for status `200`
  - the `price/plan/credit_grants/items/metadata` response's property type changed from no type to `object` for status `200`
  - the `price/plan/credit_grants/items/status` response's property type changed from no type to `string` for status `200`
  - the `price/plan/metadata` response's property type changed from no type to `object` for status `200`
  - the `price/plan/status` response's property type changed from no type to `string` for status `200`
  - the `price/price_unit_tiers/items/` response's property type changed from no type to `object` for status `200`
  - the `price/price_unit_type` response's property type changed from no type to `string` for status `200`
  - the `price/pricing_unit/metadata` response's property type changed from no type to `object` for status `200`
  - the `price/pricing_unit/status` response's property type changed from no type to `string` for status `200`
  - the `price/status` response's property type changed from no type to `string` for status `200`
  - the `price/tiers/items/` response's property type changed from no type to `object` for status `200`
  - the `price/transform_quantity` response's property type changed from no type to `object` for status `200`
  - the `price/type` response's property type changed from no type to `string` for status `200`
  - the `price_type` response's property type changed from no type to `string` for status `200`
  - the `status` response's property type changed from no type to `string` for status `200`
  - added the new `ADDON` enum value to the `price/entity_type` response property for the response status `200`
  - added the new `ADVANCE` enum value to the `invoice_cadence` response property for the response status `200`
  - added the new `ADVANCE` enum value to the `price/invoice_cadence` response property for the response status `200`
  - added the new `ARREAR` enum value to the `invoice_cadence` response property for the response status `200`
  - added the new `ARREAR` enum value to the `price/invoice_cadence` response property for the response status `200`
  - added the new `BILLING_PERIOD` enum value to the `price/meter/reset_usage` response property for the response status `200`
  - added the new `COSTSHEET` enum value to the `price/entity_type` response property for the response status `200`
  - added the new `CUSTOM` enum value to the `price/price_unit_type` response property for the response status `200`
  - added the new `FIAT` enum value to the `price/price_unit_type` response property for the response status `200`
  - added the new `FIXED` enum value to the `price/type` response property for the response status `200`
  - added the new `FIXED` enum value to the `price_type` response property for the response status `200`
  - added the new `NEVER` enum value to the `price/meter/reset_usage` response property for the response status `200`
  - added the new `PLAN` enum value to the `price/entity_type` response property for the response status `200`
  - added the new `PRICE` enum value to the `price/entity_type` response property for the response status `200`
  - added the new `SUBSCRIPTION` enum value to the `price/entity_type` response property for the response status `200`
  - …47 more
- **2026-07-09** `4b1a811c4179`: 47 breaking, 24 warning, 35 info
  - removed the enum value `create_prorations` of the request property `proration_behavior`
  - removed the enum value `none` of the request property `proration_behavior`
  - the `proration_behavior` request property type changed from `string` to no type
  - the `commitment_time_buckets/items/` response's property type changed from `object` to no type for status `200`
  - the `created_at` response's property format changed from `date-time` to no format for status `200`
  - the `end_date` response's property format changed from `date-time` to no format for status `200`
  - the `entity_type` response's property type changed from `string` to no type for status `200`
  - the `invoice_cadence` response's property type changed from `string` to no type for status `200`
  - the `price/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `price/end_date` response's property format changed from `date-time` to no format for status `200`
  - the `price/entity_type` response's property type changed from `string` to no type for status `200`
  - the `price/group/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `price/group/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `price/invoice_cadence` response's property type changed from `string` to no type for status `200`
  - the `price/metadata` response's property type changed from `object` to no type for status `200`
  - the `price/meter/aggregation` response's property type changed from `object` to no type for status `200`
  - the `price/meter/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `price/meter/filters/items/` response's property type changed from `object` to no type for status `200`
  - the `price/meter/reset_usage` response's property type changed from `string` to no type for status `200`
  - the `price/meter/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `price/plan/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `price/plan/credit_grants/items/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `price/plan/credit_grants/items/credit_grant_anchor` response's property format changed from `date-time` to no format for status `200`
  - the `price/plan/credit_grants/items/end_date` response's property format changed from `date-time` to no format for status `200`
  - the `price/plan/credit_grants/items/metadata` response's property type changed from `object` to no type for status `200`
  - the `price/plan/credit_grants/items/start_date` response's property format changed from `date-time` to no format for status `200`
  - the `price/plan/credit_grants/items/status` response's property type changed from `string` to no type for status `200`
  - the `price/plan/credit_grants/items/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `price/plan/metadata` response's property type changed from `object` to no type for status `200`
  - the `price/plan/status` response's property type changed from `string` to no type for status `200`
  - the `price/plan/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `price/price_unit_tiers/items/` response's property type changed from `object` to no type for status `200`
  - the `price/price_unit_type` response's property type changed from `string` to no type for status `200`
  - the `price/pricing_unit/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `price/pricing_unit/metadata` response's property type changed from `object` to no type for status `200`
  - the `price/pricing_unit/status` response's property type changed from `string` to no type for status `200`
  - the `price/pricing_unit/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `price/start_date` response's property format changed from `date-time` to no format for status `200`
  - the `price/status` response's property type changed from `string` to no type for status `200`
  - the `price/tiers/items/` response's property type changed from `object` to no type for status `200`
  - …66 more
- **2026-06-16** `257509e66883`: 6 info
  - added the optional property `commitment_time_buckets/items/commitment_type` to the response with the `200` status
  - added the optional property `commitment_time_buckets/items/commitment_value` to the response with the `200` status
  - added the optional property `commitment_time_buckets/items/id` to the response with the `200` status
  - added the optional property `commitment_time_buckets/items/overage_factor` to the response with the `200` status
  - added the optional property `commitment_time_buckets/items/price_id` to the response with the `200` status
  - added the optional property `commitment_time_buckets/items/true_up_enabled` to the response with the `200` status
- **2026-06-10** `2a40f94de722`: 1 info
  - added the optional property `commitment_time_buckets` to the response with the `200` status
- **2026-06-03** `7adf4f33ea1a`: 1 info
  - added the optional property `price/sequence` to the response with the `200` status
- **2026-05-18** `8ec2edea6b20`: 4 warning
  - removed the optional property `details` from the response with the `400` 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 `500`
- **2026-04-25** `5cfd03c5fc75`: 1 warning
  - removed the optional property `trial_period_days` from the response with the `200` status
- **2026-04-23** `2ead4d5de7c1`: 2 warning, 2 info
  - removed the optional property `price/trial_period` from the response with the `200` status
  - removed the optional property `trial_period` from the response with the `200` status
  - added the optional property `price/trial_period_days` to the response with the `200` status
  - added the optional property `trial_period_days` to the response with the `200` status
- **2026-04-22** `147c5358b6c7`: 2 info
  - added the new optional request property `proration_behavior`
  - added the optional property `addon_association_id` to the response with the `200` status
- **2026-04-10** `5856ed2fbdd6`: 3 warning, 1 info
  - added the new `ONETIME` enum value to the `billing_period` response property for the response status `200`
  - added the new `ONETIME` enum value to the `commitment_duration` response property for the response status `200`
  - added the new `ONETIME` enum value to the `price/billing_period` response property for the response status `200`
  - removed the `ONETIME` enum value from the `price/billing_cadence` response property for the response status `200`
- **2026-04-06** `95af41a12111`: 4 warning, 8 info
  - removed the optional property `error` from the response with the `400` status
  - removed the optional property `error` from the response with the `500` status
  - removed the optional property `success` from the response with the `400` status
  - removed the optional property `success` from the response with the `500` status
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `500` status
  - added the optional property `details` to the response with the `400` status
  - added the optional property `details` to the response with the `500` status
  - added the optional property `http_status_code` to the response with the `400` status
  - added the optional property `http_status_code` to the response with the `500` status
  - added the optional property `message` to the response with the `400` status
  - added the optional property `message` to the response with the `500` status
- **2026-03-02** `8ab89ff34fdc`: 1 info
  - added the optional property `price/meter/aggregation/expression` to the response with the `200` status

---

[Operation](https://skmtc.dev/flexprice/apis/flexprice-api/docs/subscriptions/lineitems/:id/delete.md) - [API](https://skmtc.dev/flexprice/apis/flexprice-api.md) - [Page](https://skmtc.dev/flexprice/apis/flexprice-api/changes/subscriptions/lineitems/:id/delete)
