Skip to main content
POST
cURL
Remove from a customer’s quota allowance for a feature. Defaults to 1 if count is omitted. Returns 400 insufficient_balance if the balance would go negative.

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.

Body

application/json
featureCode
string
required
Required string length: 1 - 50
Pattern: ^[a-z0-9_]+$
customerId
string
required
Required string length: 1 - 200
count
integer
default:1
Required range: x <= 9007199254740991

Response

Success

id
string
required
customerId
string
required
featureCode
string
required
previousBalance
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
newBalance
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
ts
string<date-time>
required
createdAt
string<date-time>
required
object
string
required
Allowed value: "usage_quota_event"
livemode
boolean
required