Adds frozen fields property to Invoice Items
What’s new
Adds the frozen_fields property to the Invoice Item object. This read-only array indicates which properties a user can’t modify when updating an invoice item, invoice line item, or bulk line items. Possible values might include discounts, pricing, and quantity. Attempting to update a frozen property returns an error.
Impact
If your integration updates invoice items programmatically, check the frozen_fields property before making update requests. Modifying a property listed in frozen_fields returns a 400 error. Only invoice items with derived values (for example, prorations) have properties in frozen_fields.
To make changes to a property listed in the frozen_fields array, you must delete the invoice item from the Invoice and then recreate the invoice item that includes the updated values.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| frozen_fields | Added | InvoiceItem |
Upgrade
- View your current API version in Workbench.
- If you use an SDK, upgrade to the corresponding SDK version for this API version.
- If you don’t use an SDK, update your API requests to include Stripe-Version: 2026-08-26. dahlia
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.