Skip to main content
POST
Python SDK
Pass the exact customerId as a URL-encoded query value. capCents is the most the customer can spend on overage in one billing period, in cents. It replaces the plan’s default overageCapCents for this customer, so it can be higher or lower than the default, and 0 turns overage off for them. Send { "capCents": null } to clear it and restore the plan default. There is no delete route. Call this from your own billing page when a customer changes their limit. The cap only matters while the customer’s active paid plan has overage. You can set it at any time, and it applies to the current period straight away: Track usage compares the period’s overage cost with the new cap on the next request. The response returns the saved cap and the customer’s overage for the current period, or null when their plan has no overage. Unknown customers return 404 customer_not_found. The key needs the customers:write permission.

Authorizations

Authorization
string
header
required

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

Query Parameters

customerId
string
required
Required string length: 1 - 255

Body

application/json
capCents
integer | null
required

The customer's monthly overage cap in cents. It replaces the plan default, higher or lower. Null clears it and restores the plan default.

Required range: 0 <= x <= 2147483647

Response

Customer overage cap saved

customerId
string
required
capCents
integer | null
required
Required range: x >= 0
overage
object | null
required