Skip to main content
A sandbox paid with credits can run for as long as your balance covers it. BoxRouter reserves one hour at a time and renews the reservation before each hour ends. You don’t pick a lifetime. Before You Begin: BOXROUTER_API_KEY set and a client installed, as in the quickstart, and credits in your balance.

Create It

Leave out lifetime_seconds and set resources.extendable_lifetime. funded_until is when the current reservation ends:
Python writes the offset as +00:00. funded_until moves an hour later at each renewal. If your available balance can’t cover the next hour, the sandbox ends at funded_until. Top up automatically or set a low-balance alert to stay ahead of it. A sandbox paid with your own provider account has no funded_until. On a route that can’t extend a lifetime, or when you set lifetime_seconds, BoxRouter reserves the whole lifetime when the sandbox starts.

What a Reservation Is

A reservation is held from your balance, not spent. It shows as reserved until the provider’s records set the charge, and the charge is the provider’s cost, never the reservation. A read of the sandbox says how it is reserved in charge.funding: See what a sandbox was charged for the rest of charge.

Next Steps

Buy and Manage Credits

Buy credits, top up automatically and get low-balance alerts.

Understand the Lifecycle

How a lifetime starts, ends and is extended.

Create a Sandbox

Size, lifetime and labels for the sandbox you create.