import { Autumn } from 'autumn-js'
const autumn = new Autumn()
const result = await autumn.features.create({
name: "API Calls",
type: "metered",
consumable: true,
featureId: "api-calls",
});{
"id": "api-calls",
"name": "API Calls",
"type": "metered",
"consumable": true,
"archived": false,
"display": {
"singular": "API call",
"plural": "API calls"
}
}
Create Feature
Creates a new feature.
Use this to programmatically create features for metering usage, managing access, or building credit systems.
import { Autumn } from 'autumn-js'
const autumn = new Autumn()
const result = await autumn.features.create({
name: "API Calls",
type: "metered",
consumable: true,
featureId: "api-calls",
});{
"id": "api-calls",
"name": "API Calls",
"type": "metered",
"consumable": true,
"archived": false,
"display": {
"singular": "API call",
"plural": "API calls"
}
}
Body Parameters
Response
{
"id": "api-calls",
"name": "API Calls",
"type": "metered",
"consumable": true,
"archived": false,
"display": {
"singular": "API call",
"plural": "API calls"
}
}
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Body
The name of the feature.
The type of the feature. 'single_use' features are consumed, like API calls, tokens, or messages. 'continuous_use' features are allocated, like seats, workspaces, or projects. 'credit_system' features are schemas that unify multiple 'single_use' features into a single credit system.
boolean, metered, credit_system, ai_credit_system The ID of the feature to create.
Whether this feature is consumable. A consumable feature is one that periodically resets and is consumed rather than allocated (like credits, API requests, etc.). Applicable only for 'metered' features.
Singular and plural display names for the feature in your user interface.
Show child attributes
Show child attributes
A schema that maps 'single_use' feature IDs to credit costs. For classic credit systems only — AI credit systems use model_markups instead.
Show child attributes
Show child attributes
Per-model markup overrides for AI credit systems. Maps model IDs to their markup configuration.
Show child attributes
Show child attributes
Default percentage markup for this AI credit system. Used when no model or provider markup applies. Use -100 to make usage free.
x >= -100Per-provider default markup percentages for AI credit systems. Provider keys match the first segment of model_id.
Show child attributes
Show child attributes
Response
OK
The unique identifier for this feature, used in /check and /track calls.
Human-readable name displayed in the dashboard and billing UI.
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.
boolean, metered, credit_system, ai_credit_system For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
Whether the feature is archived and hidden from the dashboard.
Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
For credit_system features: maps metered features to their credit costs.
Show child attributes
Show child attributes
Per-model markup overrides for AI credit systems.
Show child attributes
Show child attributes
Default percentage markup for AI credit systems. Use -100 to make usage free.
x >= -100Per-provider default markup percentages for AI credit systems.
Show child attributes
Show child attributes
Display names for the feature in billing UI and customer-facing components.
Show child attributes
Show child attributes