Docs /
Errors
Every error from the CLI and the API says what happened, why, and what to do. Clients branch on the code, never on the message.
| Code | HTTP | Meaning |
|---|---|---|
validation.invalid | 400 | Invalid request |
config.invalid | 400 | Invalid lobsite.toml |
auth.required | 401 | Not logged in |
auth.invalid_token | 401 | Invalid token |
auth.email_unverified | 403 | Email not confirmed |
auth.forbidden | 403 | No access to this site |
site.not_found | 404 | Site not found |
site.expired | 410 | Temporary site expired |
site.suspended | 403 | Site suspended |
site.name_invalid | 400 | Invalid site name |
site.name_taken | 409 | Name taken |
site.name_system | 403 | System name |
site.name_reserved | 403 | Reserved name |
deploy.not_found | 404 | Deploy not found |
deploy.blobs_missing | 409 | Uploads missing |
deploy.not_ready | 409 | Deploy not ready |
deploy.not_uploading | 409 | Deploy already finalized |
deploy.no_previous | 409 | No earlier deploy |
content.reserved_path | 422 | Reserved path |
content.secret_file | 422 | Secret file |
content.blocked_type | 422 | Blocked file type |
content.sensitive_form | 422 | Sensitive form fields |
content.held_for_review | 202 | Held for review |
limit.files | 422 | Too many files |
limit.file_size | 422 | File too large |
limit.site_size | 422 | Deploy too large |
limit.storage | 422 | Storage full |
limit.sites | 422 | Too many sites |
limit.domains | 422 | Too many domains |
limit.deploy_rate | 429 | Too many deploys |
limit.submissions | 429 | Submission quota used up |
domain.invalid | 400 | Invalid domain |
domain.taken | 409 | Domain on another site |
domain.not_found | 404 | Domain not found |
domain.apex_unsupported | 422 | Apex domain unsupported |
form.not_found | 404 | Form not found |
feature.coming_soon | 403 | Coming soon |
upload.hash_mismatch | 400 | Hash mismatch |
upload.token_invalid | 401 | Invalid upload token |
upload.token_expired | 401 | Upload token expired |
upload.too_large | 413 | Upload too large |
rate_limited | 429 | Too many requests |
route.not_found | 404 | No such endpoint |
cli.outdated | 426 | CLI outdated |
internal | 500 | Unexpected error |