The reservation rule
Creating work reserves its worst case, which is itstimeoutMs at $1.10/h, from creation until it ends. The plane admits new work only if that worst case fits:
- Work is prepaid, with or without a saved card. Every reservation together must fit in the remaining credit, including signup, purchased and operator-granted credit. Otherwise the answer is 402
payment-method-required. Saving a card alone does not fund work. Buy credit or enable auto-reload in the console under Billing. - With an enforced monthly budget, this month’s spend beyond the credit, plus every reservation the remaining credit does not cover, must fit under the budget. Credit never counts against a budget, so a team with granted credit is not stopped at the default $50. Otherwise the answer is 402
budget-exceeded.
timeoutMs you need, not the maximum. Lengthening a sandbox’s timeout reserves the difference.
Budgets and invoices
- A new team starts with a monthly budget of $50, enforced. The owner changes it in the console (
PUT /v1/billing/budgetwith{"limitUsd": number | null, "enforce": boolean}, session only, owners only). - Alerts fire once a month at 50%, 80% and 100% of the budget.
- Credit is consumed as work runs; there is no monthly usage charge beyond it. Owners buy credit or enable auto-reload in the console.
- An amount under Stripe’s $0.50 minimum is carried to the next month, as status
deferred.
Billing calls
Saving a card alone does not add prepaid credit. On a deployment withmode: "off", payment-changing calls answer 409 billing-unavailable.
modeislive(real cards through Stripe),test(the test checkout or a Stripe test key: no real money moves) oroff(card payments are not open yet: work is limited to available granted credit, andPOST /v1/billing/checkoutanswers 409billing-unavailable).cardisnulluntil a card is added.statusisactiveorpast_due. Apast_dueobject also hasfailureMessage.reservedUsdis what in-flight work holds beyond what it has already used.postpaidandceilingare set only for a few accounts billed monthly by arrangement. Other teams can ignore them.