Skip to main content
Configure bead usage alerts and read usage alongside credit to understand your spending. Observed usage can arrive before all charges and reservations settle.

Check your balance

Balance reports funds, reservations, and available credit. See Prepaid credit for those distinctions.

Read account and machine usage

With admin scope, read the organization’s usage projection:
The result includes spend_today_units, usage, and whether the organization has a billing customer. Use the unit metadata returned by GET /v1/pricing to interpret ledger amounts. Read a machine’s observed cost separately:
A running machine’s observed cost is not a final invoice. Late confirmed usage and reserved exposure can change the reconciled balance.

Configure a low-credit alert

The admin-scoped billing alert operation uses ledger units. Set ALERT_THRESHOLD_UNITS to your chosen threshold in ledger units, then write a request file:
The alert threshold does not stop work or add funds. Configure automatic refill separately if you want authorized card refills.

Control your spend

Use a bounded timeout for temporary work, delete finished machines, and retire snapshots you no longer need. Paused persistent machines still retain billable storage. Estimate workload cost before large batches. Run bead pricing or call GET /v1/pricing for current rates.