Skip to main content
PUT
cURL
Configure regional prices and feature overage values for one currency. Currency-specific offer terms are managed through Offers. Publishes a new current version of the plan. New buyers get it; existing subscribers stay on their version until you move them with Change subscription version or Move subscribers to a plan version.

Authorizations

x-api-key
string
header
required

Headers

Idempotency-Key
string

Unique key used to safely retry this write for 24 hours without applying it twice.

Required string length: 1 - 200
Commet-Version
string
default:2026-08-27

API version used by this reference. Send this header to select this contract explicitly.

Path Parameters

id
string
required

Body

application/json
currency
enum<string>
required
Available options:
usd,
ars,
brl,
clp,
cop,
pen,
uyu,
pyg,
bob,
mxn,
cad,
eur,
gbp,
jpy,
cny,
krw,
hkd,
sgd,
twd,
inr,
thb
exchangeRate
number
required
prices
object[]
features
object[]

Response

Success

planId
string
required
currency
string
required
exchangeRate
number
required
pricesConfigured
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
featuresConfigured
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
object
string
required
Allowed value: "plan_regional_pricing"
livemode
boolean
required