Lemon Squeezy icon

Lemon Squeezy

Interact with Lemon Squeezy API

Subscription Item → Update

AI-generated

Summary

Update a Lemon Squeezy subscription item by ID, optionally changing its quantity and billing behavior. Choose whether the returned JSON:API response is simplified, and configure retries for failed requests.

Inputs

  • Subscription Item ID (required) — The ID of the subscription item to update.
  • Update Fields — Optionally set quantity (minimum 1), whether to invoice the customer immediately, and whether to disable prorations for the quantity change. The quantity field defaults to 1 when added.
  • Simplify — Defaults to true. When enabled, flattens JSON:API attributes to the top level; when disabled, returns the raw JSON:API format.
  • Retry Options — Configure retries for failed API requests. Max Retries defaults to 3 (0 disables retries; allowed range 0–10), and Initial Delay defaults to 1000 ms (allowed range 100–30000 ms, doubling on each retry).

Output shape

A single updated subscription item record.

The response uses the simplified shape by default; disable Simplify to retain the raw JSON:API structure. API failures are returned as errors after retry handling.

Links

Discussion