Skip to main content
PUT
cURL
Updates one current plan. Supply the full editable body: name, positive monthlyCredits, and monthlyPriceCents in USD cents. The id stays in the URL. Repeating the same values returns changed: false; changed values return changed: true and create a new plan version. New customers use the new version for Checkout. Existing subscriptions retain the version they already reference; an update does not move or rebill them. A paid version syncs to the selected environment’s Stripe account and reports stripeSync. Changing the price to 0 creates a free version that can be assigned without Checkout. An unknown or archived ID returns 404 not_found, and invalid amounts return 400 invalid_request. Use Get a plan first if you need the current editable values, and see Catalog for versioning and Upgrade a paid plan for changing an active customer’s subscription.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required
Required string length: 1 - 100
Pattern: ^[a-zA-Z0-9_-]+$

Body

application/json
name
string
required
Required string length: 1 - 120
monthlyCredits
integer
required
Required range: x <= 2147483647
monthlyPriceCents
integer
required
Required range: 0 <= x <= 2147483647

Response

Plan updated

item
object
required
changed
boolean
required
stripeSync
enum<string>
Available options:
synced,
pending,
failed,
awaiting_connection