Skip to main content
POST
/
v1
/
balances.delete
Typescript (SDK)
import { Autumn } from 'autumn-js'

const autumn = new Autumn()

const result = await autumn.balances.delete({
  customerId: "cus_123",
  featureId: "api_calls",
});
{
  "success": true
}

​
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.2.0
required

Body

application/json
​
customer_id
string
required

The ID of the customer.

​
entity_id
string

The ID of the entity.

​
feature_id
string

The ID of the feature.

​
balance_id
string

The ID of the balance to delete.

​
recalculate_balances
boolean

If true, deduct the deleted balance's remaining amount from the customer's other balances for the same feature after deletion.

​
interval
enum<string>

Target a specific balance by its reset interval. Use when the customer has multiple balances for the same feature with different reset intervals.

Available options:
one_off,
minute,
hour,
day,
week,
month,
quarter,
semi_annual,
year

Response

200 - application/json

OK

​
success
boolean
required