Low balance is a reactive alert that fires when your current balance falls at or below a configured dollar threshold. Unlike the predictive balance depletion forecast, which estimates when your balance will hit zero based on your spend trend, low balance fires the moment your balance crosses the threshold you set.Documentation Index
Fetch the complete documentation index at: https://concentrate.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
How it works
Low balance is evaluated reactively on incoming API requests rather than on a scheduled cycle. When a request authenticated with an API key is received:- Fetches the current balance from the billing service for the key’s actor
- Skips if no balance record exists for the actor
- Compares against your threshold — if current balance is greater than
threshold_dollars, no alert is fired - Triggers the alert when the balance is at or below the threshold
Configuration
You can configure low balance alerts from the Alerts page in your dashboard.| Setting | Description | Options |
|---|---|---|
| Enabled | Toggle the alert on or off | true / false |
| Threshold Dollars | Dollar balance at or below which the alert fires | Any positive number (e.g., 10) |
Low balance and balance depletion forecast complement each other. Low balance fires when your balance crosses a dollar threshold right now. Balance depletion forecasts when you will hit zero based on your trend. Consider enabling both for comprehensive coverage.
Edge cases
No active requests
Because low balance is reactive, it only evaluates when an authenticated API request is made. If your account is idle and no requests come in, the alert will not fire even if your balance is below the threshold. Depositing and then going quiet will delay the next check until the next request.Missing balance record
If the billing service returns no balance for the actor, the alert is skipped rather than fired.Notifications
When a low balance alert fires, you are notified via your configured channels:- Email — includes your configured threshold and a link to add funds
- SMS — a shorter summary with the same threshold figure