Skip to main content
POST
cURL
Attach a feature to a plan with limits, overage, and credits configuration. 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
featureId
string
required
Minimum string length: 1
enabled
boolean
default:true
includedAmount
integer
default:0
Required range: 0 <= x <= 9007199254740991
unlimited
boolean
default:false
overage
object
creditsPerUnit
integer | null
Required range: -9007199254740991 <= x <= 9007199254740991
pricingMode
enum<string>
default:fixed
Available options:
fixed,
ai_model
margin
integer | null
Required range: 0 <= 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