Skip to content

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": {
    "code": "not_enough_credits",
    "message": "This run needs 6 credits and the workspace has 4."
  }
}

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.