Reliability/12 of 22
Errors
Stable error codes, request IDs, and the JSON error envelope.
| Code | Meaning |
|---|---|
unauthorized | Missing or invalid credentials |
forbidden | Authenticated but not allowed |
insufficient_scope | API key missing required scope |
plan_forbidden | Feature not on your plan |
plan_limit | Quota exceeded |
rate_limited | Too many requests — see Retry-After |
daily_quota | Daily generate limit reached (guest IP or free plan) |
not_found | Resource missing |
invalid_request | Validation failed |
conflict | Duplicate slug, invite, hostname, etc. |
not_ready | Job/asset not ready yet (e.g. ZIP still building) |
premium_coming_soon | Paid 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"
}
}