Skip to main content
POST
Typescript (SDK)

​
Body Parameters

​
Response

Authorizations

​
Authorization
string
header
required

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

Headers

​
x-api-version
string
default:2.3.0
required

Body

application/json
​
feature_id
string
required

The ID of the feature.

Response

200 - application/json

OK

​
id
string
required

The unique identifier for this feature, used in /check and /track calls.

​
name
string
required

Human-readable name displayed in the dashboard and billing UI.

​
type
enum<string>
required

Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools, 'ai_credit_system' for model-based token pricing.

Available options:
boolean,
metered,
credit_system,
ai_credit_system
​
consumable
boolean
required

For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).

​
archived
boolean
required

Whether the feature is archived and hidden from the dashboard.

​
event_names
string[]

Event names that trigger this feature's balance. Allows multiple features to respond to a single event.

​
credit_schema
object[]

For credit_system features: maps metered features to their credit costs.

​
model_markups
object | null

Per-model markup overrides for AI credit systems.

​
default_markup
number

Default percentage markup for AI credit systems. Use -100 to make usage free.

Required range: x >= -100
​
provider_markups
object | null

Per-provider default markup percentages for AI credit systems.

​
display
object

Display names for the feature in billing UI and customer-facing components.