Skip to main content

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.

Balance depletion forecast is a predictive alert that estimates how many days your current balance will last at your recent spend rate. It alerts you before your balance runs out so you can top up proactively.

​
How it works

Each evaluation cycle:
  1. Fetches your current balance from the billing service
  2. Skips if balance is zero or negative — the balance is already depleted, which is a different situation
  3. Queries the last 7 days of billing data from billing_daily to calculate your average daily spend
  4. Calculates estimated days remaining — currentBalance / averageDailySpend
  5. Compares against your threshold — if estimated days remaining is less than forecast_days, an alert is triggered

​
Configuration

You can configure balance depletion alerts from the Alerts page in your dashboard.
SettingDescriptionOptions
EnabledToggle the alert on or offtrue / false
Forecast DaysAlert when estimated days remaining drops below thisAny positive number (e.g., 3)
ScopeWhat entities to monitororganization, user

​
Scope

  • Organization — monitors your organization’s shared balance. All org admins, owners, and billing members receive the alert.
  • User — monitors your personal account balance.

​
Edge cases

​
Zero daily spend

If you have had no spend in the last 7 days, the daily burn rate is zero. No alert is fired because the balance is not depleting.

​
Already depleted

If your balance is already at or below zero, this alert does not fire. Use the low balance alert for threshold-based notifications on current balance.
Balance depletion forecast and low balance alerts 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.

​
Notifications

When a balance depletion alert fires, you are notified via your configured channels:
  • Email — includes your current balance, daily burn rate, estimated days remaining, and a link to add funds
  • SMS — a shorter summary with the same key figures
Each entity is subject to a 24-hour cooldown after an alert fires.