Documentation menuLimits

Limits

Lifetimes, sizes and rate limits of the BlockAlt API and console.

On this page

Lifetimes #

ObjectLimit
Signed configuration5 minutes
Proof-of-work challenge90 seconds, single use
Token120 seconds, single use
Read-guard clearance300 seconds with the default dashboard profile (120 api, 60 strict), at most 300
Console session12 hours without activity, 7 days at most
Sign-up link24 hours, single use
Password-reset link1 hour, three wrong codes
Invitation7 days

Sizes #

ItemLimit
Request body8 KiB
Token4,096 characters
Action name1–64 of A–Z a–z 0–9 _ -
Actions per site64
Origins per site20
Hostname253 characters, lower case
idempotencyKey1–64 of A–Z a–z 0–9 _ -
Notification destinations per workspace10 enabled, 25 kept
Sites, keys, invitations and API keys per workspaceSee account limits
Top-up per payment$1 to $1,000

Rates #

  • Per visitor network, for each site: your site's rate setting (1 to 600 per minute, 60 by default) caps how often one visitor network can request challenges and tokens. A visitor network is an IPv4 address or an IPv6 /64.
  • Proof-of-work difficulty: 8 to 16 bits per site (12 by default). Each extra bit doubles the average work. A visitor network asking one site for more than 10 challenges a minute gets up to 6 extra bits before the rate limit answers 429 (an IPv6 /64 also counts toward its /48, which shares 16 times one network's rate), and a site under a sudden surge adds up to 4 bits for everyone, for as long as the surge lasts. Older version 1 scripts solve at most 20 bits: a busy network that would need more is answered 429 until it slows down. See how long the work takes.
  • Platform limits protect the shared service from floods on the browser and verification endpoints. They answer 429 rate_limited and are set well above normal traffic; contact us before a launch or a load test.

Retention #

DataKept
Protection events (decision log)7 days
Browser refusal counts (per site, minute and reason)7 days
Daily decision counts (analytics; counts only, no visitor data)As long as the site, also after it is deleted
Consumed token and challenge ids1 hour after expiry
Usage counts and credit ledgerFor accounting
Audit logFor security and accounting
Free allowance10,000 accepted verifications per workspace per calendar month

Something unclear or missing on this page? Write to support@blockalt.click.