API reference
Errors
Every error answers with a status and an error object (code, message, retryable); most also carry a detail sentence.
| Status | Meaning | What to do |
|---|---|---|
401 | Unauthorized | The key or session is missing, wrong or expired ("Invalid API key", "API key has expired"). Create a new key in the console. |
402 | Not enough credits | The balance does not cover the call's minimum. The message names both: "Insufficient Clawifi credits: needed 6, balance 2". Nothing is charged. Send the same call with "dry_run": true to check before you run it. |
403 | Account suspended | The account is suspended while a payment dispute is open. Keys stop working; you can still sign in and read the console. Email [email protected]. |
403 | plan_required | The feature needs a higher plan, for example hosted browser render (Pro or Scale) or brute-force subdomains (any paid plan). error.code is plan_required. |
409 | Conflict | Something already exists or changed: a second plan checkout ("you already have a plan, change it instead"), or a plan change that cannot apply yet. |
429 | Too many requests | Too many calls at once for your plan, or a monthly cap (hosted render minutes) is used up. Wait the seconds in the Retry-After header and retry; a monthly cap says when it resets. |
Was this page helpful? Tell us · Last updated 2026-10-22