import { Autumn } from 'autumn-js'
const autumn = new Autumn()
const result = await autumn.features.update({
name: "API Requests",
display: {
singular: "API request",
plural: "API requests",
},
featureId: "api-calls",
});{
"id": "api-calls",
"name": "API Calls",
"type": "metered",
"consumable": true,
"archived": false,
"display": {
"singular": "API call",
"plural": "API calls"
}
}
Update Feature
Updates an existing feature.
Use this to modify feature properties like name, display settings, or to archive a feature.
import { Autumn } from 'autumn-js'
const autumn = new Autumn()
const result = await autumn.features.update({
name: "API Requests",
display: {
singular: "API request",
plural: "API requests",
},
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 ID of the feature to update.
The name of the feature.
1The 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 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
Whether the feature is archived. Archived features are hidden from the dashboard.
The new ID of the feature. Feature ID can only be updated if it's not being used by any customers.
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