--- title: "Changes to Create subscription line item" method: POST path: "/subscriptions/{id}/lineitems" --- # Changes to Create subscription line item `POST /subscriptions/{id}/lineitems` > Every recorded change to this operation, newest first. ## Timeline Changed in 22 of 139 revisions. - **2026-09-01** `e1d4e27b5677`: 3 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`: 4 warning, 1 info - **2026-07-09** `646d6658479b`: 6 breaking, 2 info - **2026-07-09** `7d57386313c7`: 41 breaking, 35 warning, 49 info - **2026-07-09** `4b1a811c4179`: 73 breaking, 28 warning, 41 info - **2026-06-16** `257509e66883`: 12 info - **2026-06-11** `91e685919832`: 8 warning - **2026-06-10** `2a40f94de722`: 2 info - **2026-06-03** `7adf4f33ea1a`: 1 info - **2026-05-18** `8ec2edea6b20`: 6 warning - **2026-04-25** `5cfd03c5fc75`: 1 warning - **2026-04-23** `2ead4d5de7c1`: 3 warning, 3 info - **2026-04-22** `147c5358b6c7`: 2 info - **2026-04-10** `5856ed2fbdd6`: 4 warning, 3 info - **2026-04-06** `95af41a12111`: 6 warning, 12 info - **2026-04-04** `9013edc21339`: 4 breaking - **2026-03-02** `8ab89ff34fdc`: 1 info ## Changes - **2026-09-01** `e1d4e27b5677`: 3 info - added the new optional request property `commitment_time_buckets/items/price/bucket_size` - added the new optional request property `price/bucket_size` - added the optional property `price/bucket_size` to the response with the `201` status - **2026-08-24** `9cd0dab91f5c`: 1 info - added the optional property `price/plan/price_sync_status` to the response with the `201` status - **2026-08-24** `66536658bde6`: 1 info - added the optional property `price/feature` to the response with the `201` status - **2026-08-21** `d567e8585c2e`: 1 warning - removed the optional property `price/plan/price_sync_status` from the response with the `201` status - **2026-08-21** `edf928b9b745`: 1 info - added the optional property `price/plan/price_sync_status` to the response with the `201` status - **2026-07-31** `50b7421a9690`: 1 info - added the optional property `meter` to the response with the `201` status - **2026-07-15** `f8ecf435d25d`: 4 warning, 1 info - added the new `ADDON` enum value to the `price/plan/credit_grants/items/scope` response property for the response status `201` - 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 `404` - 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 `201` status - **2026-07-09** `646d6658479b`: 6 breaking, 2 info - the `commitment_time_buckets/items/price/end_date` request property format changed from no format to `date-time` - the `commitment_time_buckets/items/price/start_date` request property format changed from no format to `date-time` - the `end_date` request property format changed from no format to `date-time` - the `price/end_date` request property format changed from no format to `date-time` - the `price/start_date` request property format changed from no format to `date-time` - the `start_date` request property format changed from no format to `date-time` - the `billing_period_count` request property default value `1` was removed - the `billing_period_count` response's property default value `1` was removed for the status `201` - **2026-07-09** `7d57386313c7`: 41 breaking, 35 warning, 49 info - request property `commitment_time_buckets/items/price/entity_type` was restricted to a list of enum values - request property `commitment_time_buckets/items/price/invoice_cadence` was restricted to a list of enum values - request property `commitment_time_buckets/items/price/price_unit_type` was restricted to a list of enum values - request property `commitment_time_buckets/items/price/type` was restricted to a list of enum values - request property `price/invoice_cadence` was restricted to a list of enum values - request property `price/price_unit_type` was restricted to a list of enum values - request property `price/type` was restricted to a list of enum values - request property `proration_behavior` was restricted to a list of enum values - the `commitment_time_buckets/items/price/entity_type` request property type changed from no type to `string` - the `commitment_time_buckets/items/price/invoice_cadence` request property type changed from no type to `string` - the `commitment_time_buckets/items/price/price_unit_type` request property type changed from no type to `string` - the `commitment_time_buckets/items/price/transform_quantity` request property type changed from no type to `object` - the `commitment_time_buckets/items/price/type` request property type changed from no type to `string` - the `price/invoice_cadence` request property type changed from no type to `string` - the `price/price_unit_type` request property type changed from no type to `string` - the `price/transform_quantity` request property type changed from no type to `object` - the `price/type` request property type changed from no type to `string` - 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 `201` - the `entity_type` response's property type changed from no type to `string` for status `201` - the `invoice_cadence` response's property type changed from no type to `string` for status `201` - the `price/entity_type` response's property type changed from no type to `string` for status `201` - the `price/invoice_cadence` response's property type changed from no type to `string` for status `201` - the `price/metadata` response's property type changed from no type to `object` for status `201` - the `price/meter/aggregation` response's property type changed from no type to `object` for status `201` - the `price/meter/filters/items/` response's property type changed from no type to `object` for status `201` - the `price/meter/reset_usage` response's property type changed from no type to `string` for status `201` - the `price/plan/credit_grants/items/metadata` response's property type changed from no type to `object` for status `201` - the `price/plan/credit_grants/items/status` response's property type changed from no type to `string` for status `201` - the `price/plan/metadata` response's property type changed from no type to `object` for status `201` - the `price/plan/status` response's property type changed from no type to `string` for status `201` - the `price/price_unit_tiers/items/` response's property type changed from no type to `object` for status `201` - the `price/price_unit_type` response's property type changed from no type to `string` for status `201` - the `price/pricing_unit/metadata` response's property type changed from no type to `object` for status `201` - the `price/pricing_unit/status` response's property type changed from no type to `string` for status `201` - the `price/status` response's property type changed from no type to `string` for status `201` - the `price/tiers/items/` response's property type changed from no type to `object` for status `201` - the `price/transform_quantity` response's property type changed from no type to `object` for status `201` - the `price/type` response's property type changed from no type to `string` for status `201` - the `price_type` response's property type changed from no type to `string` for status `201` - …85 more - **2026-07-09** `4b1a811c4179`: 73 breaking, 28 warning, 41 info - removed the enum value `ADDON` of the request property `commitment_time_buckets/items/price/entity_type` - removed the enum value `ADVANCE` of the request property `commitment_time_buckets/items/price/invoice_cadence` - removed the enum value `ADVANCE` of the request property `price/invoice_cadence` - removed the enum value `ARREAR` of the request property `commitment_time_buckets/items/price/invoice_cadence` - removed the enum value `ARREAR` of the request property `price/invoice_cadence` - removed the enum value `COSTSHEET` of the request property `commitment_time_buckets/items/price/entity_type` - removed the enum value `CUSTOM` of the request property `commitment_time_buckets/items/price/price_unit_type` - removed the enum value `CUSTOM` of the request property `price/price_unit_type` - removed the enum value `FIAT` of the request property `commitment_time_buckets/items/price/price_unit_type` - removed the enum value `FIAT` of the request property `price/price_unit_type` - removed the enum value `FIXED` of the request property `commitment_time_buckets/items/price/type` - removed the enum value `FIXED` of the request property `price/type` - removed the enum value `PLAN` of the request property `commitment_time_buckets/items/price/entity_type` - removed the enum value `PRICE` of the request property `commitment_time_buckets/items/price/entity_type` - removed the enum value `SUBSCRIPTION` of the request property `commitment_time_buckets/items/price/entity_type` - removed the enum value `USAGE` of the request property `commitment_time_buckets/items/price/type` - removed the enum value `USAGE` of the request property `price/type` - removed the enum value `create_prorations` of the request property `proration_behavior` - removed the enum value `none` of the request property `proration_behavior` - the `commitment_time_buckets/items/price/entity_type` request property type changed from `string` to no type - the `commitment_time_buckets/items/price/invoice_cadence` request property type changed from `string` to no type - the `commitment_time_buckets/items/price/price_unit_type` request property type changed from `string` to no type - the `commitment_time_buckets/items/price/transform_quantity` request property type changed from `object` to no type - the `commitment_time_buckets/items/price/type` request property type changed from `string` to no type - the `price/invoice_cadence` request property type changed from `string` to no type - the `price/price_unit_type` request property type changed from `string` to no type - the `price/transform_quantity` request property type changed from `object` to no type - the `price/type` request property type changed from `string` to no type - 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 `201` - the `created_at` response's property format changed from `date-time` to no format for status `201` - the `end_date` response's property format changed from `date-time` to no format for status `201` - the `entity_type` response's property type changed from `string` to no type for status `201` - the `invoice_cadence` response's property type changed from `string` to no type for status `201` - the `price/created_at` response's property format changed from `date-time` to no format for status `201` - the `price/end_date` response's property format changed from `date-time` to no format for status `201` - the `price/entity_type` response's property type changed from `string` to no type for status `201` - the `price/group/created_at` response's property format changed from `date-time` to no format for status `201` - the `price/group/updated_at` response's property format changed from `date-time` to no format for status `201` - the `price/invoice_cadence` response's property type changed from `string` to no type for status `201` - …102 more - **2026-06-16** `257509e66883`: 12 info - added the new optional request property `commitment_time_buckets/items/commitment_type` - added the new optional request property `commitment_time_buckets/items/commitment_value` - added the new optional request property `commitment_time_buckets/items/id` - added the new optional request property `commitment_time_buckets/items/overage_factor` - added the new optional request property `commitment_time_buckets/items/price` - added the new optional request property `commitment_time_buckets/items/true_up_enabled` - added the optional property `commitment_time_buckets/items/commitment_type` to the response with the `201` status - added the optional property `commitment_time_buckets/items/commitment_value` to the response with the `201` status - added the optional property `commitment_time_buckets/items/id` to the response with the `201` status - added the optional property `commitment_time_buckets/items/overage_factor` to the response with the `201` status - added the optional property `commitment_time_buckets/items/price_id` to the response with the `201` status - added the optional property `commitment_time_buckets/items/true_up_enabled` to the response with the `201` status - **2026-06-11** `91e685919832`: 8 warning - the `commitment_time_buckets/items/end/hour` request property's max was set to `24.00` - the `commitment_time_buckets/items/end/minute` request property's max was set to `59.00` - the `commitment_time_buckets/items/start/hour` request property's max was set to `24.00` - the `commitment_time_buckets/items/start/minute` request property's max was set to `59.00` - the `commitment_time_buckets/items/end/hour` request property's min was set to `0.00` - the `commitment_time_buckets/items/end/minute` request property's min was set to `0.00` - the `commitment_time_buckets/items/start/hour` request property's min was set to `0.00` - the `commitment_time_buckets/items/start/minute` request property's min was set to `0.00` - **2026-06-10** `2a40f94de722`: 2 info - added the new optional request property `commitment_time_buckets` - added the optional property `commitment_time_buckets` to the response with the `201` status - **2026-06-03** `7adf4f33ea1a`: 1 info - added the optional property `price/sequence` to the response with the `201` status - **2026-05-18** `8ec2edea6b20`: 6 warning - 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` - **2026-04-25** `5cfd03c5fc75`: 1 warning - removed the optional property `trial_period_days` from the response with the `201` status - **2026-04-23** `2ead4d5de7c1`: 3 warning, 3 info - removed the request property `price/trial_period` - removed the optional property `price/trial_period` from the response with the `201` status - removed the optional property `trial_period` from the response with the `201` status - added the new optional request property `price/trial_period_days` - added the optional property `price/trial_period_days` to the response with the `201` status - added the optional property `trial_period_days` to the response with the `201` 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 `201` status - **2026-04-10** `5856ed2fbdd6`: 4 warning, 3 info - removed the request property `price/billing_cadence` - added the new `ONETIME` enum value to the `billing_period` response property for the response status `201` - added the new `ONETIME` enum value to the `commitment_duration` response property for the response status `201` - added the new `ONETIME` enum value to the `price/billing_period` response property for the response status `201` - added the new `ONETIME` enum value to the request property `commitment_duration` - added the new `ONETIME` enum value to the request property `price/billing_period` - removed the `ONETIME` enum value from the `price/billing_cadence` response property for the response status `201` - **2026-04-06** `95af41a12111`: 6 warning, 12 info - removed the optional property `error` from the response with the `400` status - removed the optional property `error` from the response with the `404` 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 `404` 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 `404` 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 `404` 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 `404` 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 `404` status - added the optional property `message` to the response with the `500` status - **2026-04-04** `9013edc21339`: 4 breaking - the `end_date` request property format changed from no format to `date-time` - the `price/end_date` request property format changed from no format to `date-time` - the `price/start_date` request property format changed from no format to `date-time` - the `start_date` request property format changed from no format to `date-time` - **2026-03-02** `8ab89ff34fdc`: 1 info - added the optional property `price/meter/aggregation/expression` to the response with the `201` status --- [Operation](https://skmtc.dev/flexprice/apis/flexprice-api/docs/subscriptions/:id/lineitems/post.md) - [API](https://skmtc.dev/flexprice/apis/flexprice-api.md) - [Page](https://skmtc.dev/flexprice/apis/flexprice-api/changes/subscriptions/:id/lineitems/post)