Running low or out of credits

When your balance reaches zero, everything that spends credits stops: agent replies on every channel, knowledge ingestion and workflow steps that cost credits. Nothing is deleted. Buy credits and everything resumes at once.

The warnings

These emails are always on, so you can't miss a billing problem (Settings → Notifications lists them).

What callers see at zero

• API: 402 Payment Required with code OUT_OF_CREDITS, the message "You're out of credits. Buy credits to continue.", your balance and a buy_url (/settings?tab=billing).
• Website widget: visitors see "This assistant is unavailable right now. Please try again later."
• Workflows: runs that need a credit are refused with 402 OUT_OF_CREDITS.
• Knowledge: an upload or crawl that needs more credits than you have is refused; a crawl skips pages beyond your balance. A crawl needs at least 5 credits to start.

Check these in order

1. 1

   Buy a pack

   Billing → Buy credits. Replies resume as soon as the payment succeeds. See Buy credits.

2. 2

   Turn on auto top-up

   So it doesn't happen again. See Auto top-up.

3. 3

   If auto top-up was on

   Check the Auto top-up panel for a pause reason or a reached monthly limit.

4. 4

   Find what spent them

   Settings → Usage splits spending between replies and knowledge; Analytics shows requests per agent. A spike usually means a busy widget or a loop in your own code.