API v1

Errors

Errors return a JSON body with an error field describing the issue. The HTTP status code tells you the category.

Error format

Error response

400 Bad Request

{
  "error": "Message must be between 1 and 2000 characters"
}

The body always contains a single error string. Use the HTTP status code (not the message) for programmatic branching — messages may be reworded over time.

Error codes

Code	Meaning	What to do
400	Invalid request — message missing, empty, or exceeds 2000 characters.	Check your request body and message length.
401	Invalid, revoked, or expired API key.	Verify your key is correct and active in the dashboard.
403	API key not authorized for this chatbot, or your IP is not in the key’s allowlist.	Use a key scoped to the correct chatbot. Check IP restrictions.
429	Rate limit exceeded, daily message cap reached, or monthly credits depleted.	Wait for the rate-limit window to reset, or upgrade your plan.
503	Service temporarily overloaded.	Retry with exponential backoff.

Rate limits

How rate limits, daily caps, and monthly credits interact — and which one triggered your 429.

Code examples

Production-ready clients with retries and error handling baked in.