Skip to main content
PATCH
cURL
Update limits, overage, or enabled status of a feature on a plan. 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
featureId
string
required

Body

application/json
enabled
boolean
includedAmount
integer
Required range: 0 <= x <= 9007199254740991
unlimited
boolean
overage
object
creditsPerUnit
integer | null
Required range: -9007199254740991 <= x <= 9007199254740991

Response

Success

planId
string
required
featureId
string
required
enabled
boolean
required
includedAmount
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
unlimited
boolean
required
overage
object
required
creditsPerUnit
integer | null
required
Required range: -9007199254740991 <= x <= 9007199254740991
pricingMode
enum<string>
required
Available options:
fixed,
ai_model
margin
integer | null
required
Required range: -9007199254740991 <= x <= 9007199254740991
object
string
required
Allowed value: "plan_feature"
livemode
boolean
required