Skip to main content

The reservation rule

Creating work reserves its worst case, which is its timeoutMs 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.
Because running work can never spend more than its reservation, an enforced budget is never exceeded, and nothing is killed mid-run to keep that promise. Ask for the 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/budget with {"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 with mode: "off", payment-changing calls answer 409 billing-unavailable.
  • mode is live (real cards through Stripe), test (the test checkout or a Stripe test key: no real money moves) or off (card payments are not open yet: work is limited to available granted credit, and POST /v1/billing/checkout answers 409 billing-unavailable).
  • card is null until a card is added.
  • status is active or past_due. A past_due object also has failureMessage.
  • reservedUsd is what in-flight work holds beyond what it has already used.
  • postpaid and ceiling are set only for a few accounts billed monthly by arrangement. Other teams can ignore them.