Skip to main content
PUT
cURL

Authorizations

Authorization
string
header
required

JWT Bearer token obtained from authentication. Pass as: Authorization: Bearer

Body

application/json

Patch for overage settings; missing fields preserve current values

enabled
boolean

Opt in to (or out of) metered overage

limitCents
integer

Overage to authorize above the included allowance, in cents

Required range: x >= 0
monthlySpendCents
integer | null

Absolute ceiling; null CLEARS it, omitting the field leaves it unchanged

Required range: x >= 0

Response

200 - application/json

OK

Metered-overage authorization for the requesting org

enabled
boolean
required

Whether the customer has opted in to metered overage

limitCents
integer
required

Overage the customer authorized above their included allowance, in cents

Required range: x >= 0
monthlySpendCents
integer | null
required

Customer's own absolute ceiling; lowers the cap but never raises it

Required range: x >= 0
effectiveCapCents
integer
required

What enforcement actually compares spend against; 0 when overage is off

Required range: x >= 0
usedCents
integer
required

Metered overage accrued so far this billing period, in cents

Required range: x >= 0
planCeilingCents
integer | null
required

Most this plan permits authorizing; null on Enterprise (no ceiling)

Required range: x >= 0
period
string
required

Billing-period key the usage figure covers