Errors

Status codes

Code	Meaning
`200`	Success.
`400`	Bad request — check the error details (e.g. an invalid `coverage_state` value or malformed `updated_since` timestamp).
`401`	Unauthorized — the token is invalid or revoked.
`403`	Forbidden — access denied.
`404`	Not found — also returned for resources outside your studio.
`429`	Rate limited — see Rate limits; includes `Retry-After` and `X-RateLimit-*` headers.
`5xx`	Server error — logged on our side with the `request_id`.

Errors return a JSON object with a machine-readable code, a human-readable message, and a request_id you can quote to support:

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded. Retry after 30s.",
    "request_id": "req_abc123"
  }
}

When a server-side error occurs, the response body includes a request_id field at the top level:

{
  "error": "run_failed",
  "message": "Something went wrong.",
  "request_id": "iad1::abc123"
}

Quote this value when contacting support — it lets us find the exact call in our logs.

Include the request_id when contacting support about a failed request — it lets us find the exact call in our logs.