Reliability/12 of 22

Errors

Stable error codes, request IDs, and the JSON error envelope.

CodeMeaning
unauthorizedMissing or invalid credentials
forbiddenAuthenticated but not allowed
insufficient_scopeAPI key missing required scope
plan_forbiddenFeature not on your plan
plan_limitQuota exceeded
rate_limitedToo many requests — see Retry-After
daily_quotaDaily generate limit reached (guest IP or free plan)
not_foundResource missing
invalid_requestValidation failed
conflictDuplicate slug, invite, hostname, etc.
not_readyJob/asset not ready yet (e.g. ZIP still building)
premium_coming_soonPaid checkout not enabled yet

Official SDKs surface these as typed errors with code, status, optional retryAfterSeconds, and requestId.

json
{
  "error": {
    "code": "invalid_request",
    "message": "…",
    "request_id": "uuid"
  }
}