Skip to main content

Usage & Billing

Usage & Billing is where organization billing managers track spend, manage limits, and buy credit. Open it from organization settings (or go to https://devs.ai/usage-billing when the experience is enabled for your organization).

This page covers a Monthly spend limit for Chat, Auto-reload for Chat credit, and redeeming a promotional code. Shared unit budgets live on the Org Units tab. For more information, see Organization Units.

📝 Note: Usage & Billing and Auto-reload require dollar-based billing and roll out as they are enabled for each organization. Who can change billing depends on your role’s permissions (typically the same access used to buy a top-up).

Monthly spend limit for Chat​

Org admins can set a Monthly spend limit for Chat on Usage & Billing. The page shows how much of that limit is used and when it resets.

Spend alerts​

Turn on Spend alerts to email org admins (and any extra addresses you add) when spend reaches a percent of the limit. Each alert sends at most once per month.

Enforce hard limit​

Turn on Enforce hard limit if Chat should pause once this month’s spend reaches the limit. Auto-reload also pauses in that case. When enforcement is off, the limit is only used for alerts.

This control is available on the same plans as auto-reload. If you do not see Monthly spend limit, Usage & Billing may not be enabled for your organization yet.

Auto-reload for Chat credit​

Auto-reload adds Chat credit automatically when the spendable Chat balance reaches a threshold you set. Teams can keep working without waiting for someone to buy credit by hand.

Auto-reload does not top up App Builder build credit or other balance types.

Set up auto-reload​

  1. Open Usage & Billing.
  2. In the Auto-reload section, choose Set up auto-reload.
  3. Set When the balance reaches (threshold) and Reload amount.
  4. Optionally turn on Set monthly limit for auto reload and enter a Monthly reload limit. Reloads stop for the rest of the calendar month (UTC) once that limit is reached.
  5. Add or confirm a card on file, then Continue and click Confirm.

Reloads are charged in USD. The reload amount must be at least $10, more than the threshold, in whole cents. If the balance is already at the threshold when you confirm, the card can be charged immediately.

Edit, pause, and turn back on​

  • Edit — Change threshold, amount, monthly limit, or card. Saving an edit does not charge the card by itself.
  • Turn off — Stops new reloads. A charge already sent to the card can still finish. Your threshold, amount, and card are kept.
  • Turn back on — Starts a fresh reload cycle. If the balance is still at or below the threshold, the card may be charged when you enable it again.

If a charge fails, auto-reload can show as Paused until you turn it back on. After a successful reload, if the balance is still at or below the threshold, another reload does not run until the balance rises above the threshold and falls again—or you turn auto-reload off and on.

Eligibility​

Auto-reload is available when your organization’s subscription qualifies (for example a paid plan that can buy Chat top-ups through the platform). Marketplace-managed or ineligible subscriptions may not offer it. If you do not see Auto-reload, it may not be enabled for your organization yet, or your role may not have billing top-up access.

Redeem a promotional code​

Organization admins on a free plan can redeem a promotional code when promotional codes are enabled for the organization. Marketplace-billed free organizations can use the same flow.

  1. Open the upgrade or plan picker (for example from Upgrade in the product).
  2. In Promotional code, enter the code.
  3. Choose Redeem Promotional Code.

On success, you see Promo code applied! and Your promotional trial has been activated. Codes apply only on a free plan; if promotional codes are turned off for your organization, the redeem section is not available.

  • Organization Units. Shared spend limits on the Org Units tab of Usage & Billing.
  • Analytics. Usage and cost reporting (separate from buying credit).
  • User permissions. Who can manage organization billing and related settings.
  • App Builder. Low build credit warnings (separate from Chat auto-reload).
⌘J