BILLING_API scope. Writes run as the key’s service account owner. This API does not invite or deactivate members. Use the User Management API for that.
Base URL
Prerequisites
- API key with the
BILLING_APIscope - The key owner is a service account that has not been deleted and has an active Admin membership
USER_MANAGEMENT_APIon the same key when you needemail,name, or an email filter
Set an extra usage budget
PUT /users/{userId}/extra-usage-budget takes the budget directly. There is no wrapper field.
{ "type": "none" } removes the extra allowance. { "type": "unlimited" } removes the numeric cap. A limited amount may be zero.
If the effective budget was limited and the new effective budget is higher or unlimited, the member’s pending usage request is closed. The same budget or a lower one leaves the request open. Without usageRequestId, the budget is saved even if closing the request fails.
Pass usageRequestId as a query parameter to answer that request in the same write. The budget is kept only when the request belongs to this member, is still pending, and the effective budget rises as described above. Otherwise nothing is written. A missing request, or one that is not this member’s, returns 404 with code NOT_FOUND. A request that is no longer pending returns 409 with code USAGE_REQUEST_NOT_PENDING. A change that does not raise the allowance returns 409 with code USAGE_REQUEST_NOT_ANSWERED. The request stays pending.
The response is the member object with extraUsagePeriodSpend set to null.
Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on API Key Best Practices.