Skip to content
Docs

Limits and errors

Sites and deploy

Limit Value or action
Redirect rules Root _redirects: 1000 rules by default (REDIRECTS_MAX_RULES), 128 KiB per file, 2048 bytes per line; redirects_invalid reports line errors
Archive entries 50,000 entries
Deleted sites Recently deleted for 7 days
Preview links A preview link stops working after an hour
File and archive size Each upload may be at most 25 MB.
Blocked files Keep executables, installers, and archives outside the deployed site
Reserved names Choose another name when the response says name_reserved

Sign-in and access

Limit Value or action
Email code valid for 15 minutes
Account keys at most 50 keys
Idle key A key unused for 180 days stops working.
Visitor session Session has 30-day absolute and 14-day idle lifetimes

Storage and saved data

Limit Value or action
Shared storage pool Up to 1,000,000 bytes shared by KV, SQLite, and files
Individual file Up to 1,000,000 bytes per file
Resource allowance Read GET /v1/sites/{sitename}/storage/usage before writing
File paths At most 16 segments
Tables accessed by visitors At most 100 total columns, including server-managed columns
Query result size Up to 1,000,000 bytes per query result
Busy storage Retry after a short wait; honor Retry-After when supplied

Notifications

Limit Value or action
Subscriptions At most 10 subscriptions per site
Events At most 60 events per minute and 5,000 per day per site
History Retain IDs for the replay window, normally seven days
Receiver Public HTTPS; answer promptly with 2xx
Signature clock Within five minutes of the signed timestamp
Retry and suspension Follow Webhooks

Rate limits and retries

Honor Retry-After. Reuse the same Idempotency-Key and body when retrying a supported create request after an uncertain response. Do not reuse it for a different operation.

Area Code Action
API not_found, method_not_allowed Check path and Allow
API rate_limited Wait for Retry-After
Deploy site_exists, site_not_found Check the site name
Deploy item_too_large, site_too_large Reduce the upload
Access sign_in_required, forbidden Check account and scope
Storage row_conflict, invalid_reference Check values and parent access
Storage site_full, sqlite_full, bucket_full Remove unused data or ask the operator
Notifications invalid_url, invalid_events, client_secret Follow the setup guide