errors
Error codes
Every error is a JSON object { error: { code, message, docs? } }. The code is stable; the message is written to be actionable.
Catalog
| Code | HTTP | Meaning and fix |
|---|---|---|
| unauthorized | 401 | Missing, invalid or revoked API key. Create one in Dashboard, API. |
| forbidden | 403 | The key lacks the required scope (read / write / export). Grant it in Dashboard, API. |
| invalid_request | 400 | Malformed body or query. The message names the offending field. |
| not_found | 404 | The site, funnel or visitor does not exist in your workspace. |
| plan_limit | 403 | Your plan's site limit is reached. Upgrade or delete a site. |
| gsc_not_connected | 404 | Search Console is not connected for the site (SEO reports). |
| rate_limited | 429 | Too many requests. Back off; a Retry-After header tells you how long. |
| conflict | 409 | The resource is in a state that blocks the operation. |
| internal | 500 | Something failed on our side. Retry; if it persists, contact support. |