Errors
What went wrong, and what to do about it.
Errors use standard HTTP status codes and a body with a code you can match on and a message you can read.
Errorjson
Error codes
invalid_request400- A field is missing or not valid. The message names it.
unauthorised401- The key is missing, wrong, revoked or expired.
not_enough_credits402- The workspace does not have enough credits for this run. Free credits don’t count on a site that has already had its free run.
site_not_verified403- The site’s ownership has not been checked yet. Verify it in the site’s settings. Free runs need a verified site.
workspace_suspended403- Runs are paused for this workspace, for example after a failed payment.
plan_required403- The workspace is on the free plan. The API is on paid plans: pick one in Billing and the workspace’s keys work again.
missing_scope403- The key does not have the scope this request needs.
not_found404- No run, report or site with that id in this workspace, or no such endpoint for that method.
conflict409- A request with the same Idempotency-Key is still being handled. Wait a moment, then send it again.
rate_limited429- Too many requests. Wait for the time in Retry-After.
server_error500- Something went wrong on our side. Try again; if it keeps happening, email support@cogitable.ai.
server_error503- Cogitable can’t reach its database for a moment. Wait for the time in Retry-After, then try again.