BizKitHub
INTERNAL_AI_BUDGET_EXCEEDED

Monthly AI token budget of your tariff has been used up.

HTTP 429Platform
The organisation has consumed all AI tokens included in its tariff for the current calendar month (`limit_ai_tokens_monthly`). AI features using the shared BizKitHub key are paused until the next month.

How to resolve

  1. 1

    Upgrade the tariff in Settings → Tariff & usage to get a higher monthly AI token limit.

  2. 2

    Configure your own AI provider API key in Settings → AI (BYOK); requests using your own key are not limited by the tariff.

  3. 3

    The counter resets on the first day of the next calendar month (UTC).

Example response

The API answers with HTTP 429 and a JSON body. Match on errorCode, not on message: messages may be reworded, codes are stable.

application/json
{
  "state": "error",
  "code": 429,
  "message": "Monthly AI token budget of your tariff has been used up.",
  "errorCode": "INTERNAL_AI_BUDGET_EXCEEDED",
  "hint": "The organisation has consumed all AI tokens included in its tariff for the current calendar month (`limit_ai_tokens_monthly`). AI features using the shared BizKitHub key are paused until the next month.",
  "documentationUrl": "https://docs.bizkithub.com/errors/INTERNAL_AI_BUDGET_EXCEEDED"
}