Run it
Limits and quotas
Rate limits, storage quotas, file limits, team size, and the daily email budget, read straight from the code.
Runaway-only
Rate limitsLink to this section
Each limit counts hits per key (a user, an MCP connection, a team, an email address, or a hashed network address) over a sliding window. A refusal says what happened and when to try again, in the same words everywhere:
You have created a lot of artifacts in the last hour. Try again in about 21 minutes.
If the counters are unavailable, checks fail open: the request goes through. MCP clients should honor Retry-After and error.data.retryAfterSeconds; see MCP errors. Agents are separate users, so each agent has its own limits.
MCP and artifacts
| Limit | Allowed | Applies to | Refused as |
|---|---|---|---|
| artifactCreate | 120 per hour, per user | artifacts_create, files_create_artifact, and the web app | Tool error (isError), or in the page |
| artifactUpdate | 1,200 per hour, per user | Every artifact edit, from MCP and the web app, except web autosaves that continue an editing session | Tool error (isError), or in the page |
| artifactAutosave | 3,600 per hour, per user | Web editor autosaves that continue an editing session (the editor sends at most one every 2 seconds) | Error in the page |
| artifactUpdateByToken | 600 per hour, per token | artifacts_update, artifacts_restore_version, canvas_frame_save, canvas_frame_update, canvas_frame_delete, files_attach, files_replace, page_files_publish | HTTP 429, JSON-RPC -32029 |
| organize | 1,200 per hour, per user | Project and tag changes, from MCP and the web app | Tool error (isError), or in the page |
| harnessChoice | 600 per hour, per user | Changing an artifact's "Made with" agent or a connection's agent in the web app | Error in the page |
| editLease | 1,200 per hour, per user | The web editor's "I'm editing" signal while you type, which keeps agents from overwriting your typing | The view is not counted; the page is unaffected |
| catchUp | 600 per hour, per user | An open canvas or interface asking, when its tab comes back, whether an agent or another tab saved it (over the limit it shows the newest save on the next reload) | The view is not counted; the page is unaffected |
| clientInfoRecord | 600 per hour, per user | Storing what an MCP client says it is on initialize (over the limit it is not stored; the request still runs) | The view is not counted; the page is unaffected |
| readByUser | 3,600 per hour, per user | MCP read tool calls and opening artifacts in the workspace | HTTP 429, JSON-RPC -32029 |
| readByToken | 1,800 per hour, per token | Every MCP read tool call | HTTP 429, JSON-RPC -32029 |
| sharingRequest | 30 per hour, per user | Sharing and comments-setting changes (making private is never limited) | Tool error (isError), or in the page |
Files and pages
| Limit | Allowed | Applies to | Refused as |
|---|---|---|---|
| fileDownloadByNetwork | 3,600 per hour, per network | /api/files views and downloads | HTTP 429 with Retry-After |
| fileRequestByNetwork | 7,200 per hour, per network | Every /api/files request: views, downloads, and video and audio playback (seeks and later parts) | HTTP 429 with Retry-After |
| fileRangeByNetworkFile | 1,800 per hour, per network | /api/files playback of one file: seeks and later parts | HTTP 429 with Retry-After |
| pageFileByNetwork | 18,000 per hour, per network | The files an HTML page loads by relative path from its page host | HTTP 429 with Retry-After |
| pageAddress | 3,600 per hour, per user | Opening an HTML artifact that has page files (per network for a signed-out reader; over the limit the page runs without its files) | The view is not counted; the page is unaffected |
| teamIconByUser | 1,200 per hour, per user | /api/teams/<id>/icon team icon views (browsers keep each icon for a day) | HTTP 429 with Retry-After |
| teamIconByNetwork | 30,000 per hour, per network | /api/teams/<id>/icon team icon views | HTTP 429 with Retry-After |
| artifactPageByNetwork | 1,800 per hour, per network | /artifact/<id> pages | HTTP 429 with Retry-After |
| viewByNetwork | 1,200 per hour, per network | Counted views of public artifact pages | The view is not counted; the page is unaffected |
| viewByNetworkArtifact | 60 per hour, per network | Counted views of one public artifact page | The view is not counted; the page is unaffected |
| ogImageByNetwork | 3,600 per hour, per network | Artifact preview images (cache misses only) | HTTP 429 with Retry-After |
| reportByUser | 10 per hour, per user | Reports from signed-in readers | Error in the page |
| reportByNetwork | 5 per 15 minutes, per network | Reports, signed in or not | Error in the page |
| reportByNetworkDay | 10 per day, per network | Reports, signed in or not, each day | Error in the page |
| reportByNetworkArtifact | 3 per hour, per network | Reports about one artifact, signed in or not | Error in the page |
| fileUpload | 200 per hour, per user | files_request_upload and web uploads | Tool error (isError), or in the page |
| pageFileUpload | 1,000 per hour, per user | page_files_request_uploads, counted once for each file a call names | Tool error (isError), or in the page |
| frameCaptureNeeded | 1,200 per hour, per user | An open canvas asking which of its frames have no image yet, for people who may edit it | The frame image is not drawn now; the page is unaffected |
| frameCaptureStart | 1,200 per hour, per user | Images of canvas frames that your browser draws for agents | The frame image is not drawn now; the page is unaffected |
| frameCaptureStartByArtifact | 600 per 10 minutes, per canvas | Images of one canvas's frames, from everyone who may edit it | The frame image is not drawn now; the page is unaffected |
| frameCaptureFinish | 1,200 per hour, per user | The check of each frame image after your browser uploaded it | The frame image is not drawn now; the page is unaffected |
| frameImageRead | 600 per hour, per user | canvas_frame_image: reading the image of a canvas frame, on top of the MCP read limits | Tool error (isError), or in the page |
Teams and accounts
| Limit | Allowed | Applies to | Refused as |
|---|---|---|---|
| feedbackByUser | 5 per hour, per user | "Something's not working" reports from the account menu | Error in the page |
| teamInviteByUserHour | 20 per hour, per user | Team invitations sent | Error in the page |
| teamInviteByUserDay | 50 per day, per user | Team invitations sent | Error in the page |
| teamInviteByTeamDay | 100 per day, per team | Team invitations sent | Error in the page |
| teamCreate | 10 per hour, per user | New teams | Error in the page |
| agentCreate | 20 per hour, per user | New agent teammates | Error in the page |
| tokenCreate | 30 per hour, per user | New access tokens | Error in the page |
| pushDevice | 30 per hour, per user | Turning on browser notifications in Settings | Error in the page |
| pushTest | 10 per hour, per user | Send a test notification in Settings | Error in the page |
Comments
| Limit | Allowed | Applies to | Refused as |
|---|---|---|---|
| agentCommentMinute | 6 per minute, per user | Comments by an agent | Tool error (isError), or in the page |
| agentCommentHour | 60 per hour, per user | Comments by an agent | Tool error (isError), or in the page |
| personCommentMinute | 20 per minute, per user | Comments by a person | Error in the page |
| personCommentHour | 300 per hour, per user | Comments by a person | Error in the page |
| commentResolveMinute | 30 per minute, per user | Resolving or reopening a comment thread | Error in the page |
| commentResolveHour | 300 per hour, per user | Resolving or reopening a comment thread | Error in the page |
Sign-in and OAuth
| Limit | Allowed | Applies to | Refused as |
|---|---|---|---|
| magicLinkByNetworkMinute | 2 per minute, per network | Sign-in links, in a burst | HTTP 429 with Retry-After |
| magicLinkByNetwork | 10 per 15 minutes, per network | Sign-in links | HTTP 429 with Retry-After |
| magicLinkByNetworkDay | 20 per day, per network | Sign-in links, each day | HTTP 429 with Retry-After |
| magicLinkByEmailMinute | 1 per minute, per email address | Sign-in links, from any network | HTTP 429 with Retry-After |
| magicLinkByEmail | 5 per hour, per email address | Sign-in links, from any network | HTTP 429 with Retry-After |
| passwordSignInByNetwork | 20 per 15 minutes, per network | Password sign-in tries (accounts given a password only; IPv6 counts by /64) | HTTP 429 with Retry-After |
| passwordSignInByNetworkDay | 100 per day, per network | Password sign-in tries, each day | HTTP 429 with Retry-After |
| passwordSignInByNetworkEmail | 10 per 15 minutes, per network | Password sign-in tries for one email address from one network | HTTP 429 with Retry-After |
| passwordSignInFailuresByEmail | 500 per hour, per email address | Failed password sign-ins for one address, from any network (only failures count) | HTTP 429 with Retry-After |
| oauthRegister | 300 per hour, per network | OAuth app registration (MCP clients; IPv6 counts by /64) | HTTP 429 with Retry-After |
| oauthAuthorize | 60 per hour, per network | OAuth authorization requests | HTTP 429 with Retry-After |
| oauthToken | 36,000 per hour, per network | Every OAuth token request: a load backstop, high so hosted apps that serve many people from one address are not slowed (IPv6 counts by /64) | HTTP 429 with Retry-After |
| oauthTokenFailuresByNetwork | 60 per 15 minutes, per network | Failed OAuth token requests (IPv6 counts by /64); over it, only requests that carry no code or refresh token, or name no app this site can look up, wait | HTTP 429 with Retry-After |
| oauthRefreshByConnection | 60 per hour, per connection | Successful OAuth refreshes for one person and one app, from any network | HTTP 429 with Retry-After |
Apps that connect with OAuth refresh their access about once an hour. Hosted apps send every person's refreshes from a few shared addresses, so a successful refresh counts against its connection (one person and one app), and the address only meets a load backstop of 36,000 an hour. Failed token requests count against the address. After 60 in 15 minutes, a request from it waits only when it carries no code or refresh token, or names no app the site can look up. Every other request still gets a real answer, so an app whose connection has ended learns to ask the person to connect again, however busy its address is. Codes, refresh tokens, and client secrets are long random values that cannot be guessed. One address may register 300 apps an hour and have at most 100 that nobody has approved. When it has that many, or when 2,000 apps wait for approval in all, a new registration removes the oldest one that has waited over 15 minutes, from the same address first. For these OAuth limits, an IPv6 address counts by its /64, the block one home or phone line usually gets; IPv4 counts per address.
Storage quotaLink to this section
An account is a person plus the agents they own, so adding agents never multiplies the quota.
| Quota | Default | Counts |
|---|---|---|
| Artifact content | 104,857,600 bytes (100 MB) | Content and metadata of every artifact and every saved version. |
| Files | 1,073,741,824 bytes (1.0 GB) | Finished uploads, uploads started in the last hour, old copies of replaced files, and images of canvas frames your browser drew. |
- A save that grows an artifact counts the growth plus the new version. A save that does not grow it counts nothing, so you can always shorten, fix, or delete.
- Edits by teammates and their agents count against the author's account.
- Old versions are pruned (see Version history), which keeps history bounded.
- Self-hosted servers can change the quotas with
STORAGE_QUOTA_CONTENT_BYTESandSTORAGE_QUOTA_FILE_BYTES.
When a save does not fit, the refusal says whose quota is full:
Artifacts and their saved versions in your account use 100 MB of 100 MB, and this needs 586 KB more. Delete or shorten artifacts you no longer need, then try again.
Files in your account use 1019 MB of 1.0 GB, so this 11 MB file does not fit. Delete files you no longer need, then try again.
Artifact and spec sizeLink to this section
| Limit | Value |
|---|---|
| Content per artifact | 1,048,576 bytes (1.0 MB) |
| HTML page: the document, with the styles and scripts written in it | 1,048,576 bytes (1.0 MB) |
| Metadata per artifact | 65,536 bytes (64 KB) |
| Mermaid source | 50,000 characters |
| ui spec | 200,000 bytes (195 KB) |
| ui elements | 500 |
| ui nesting depth | 20 |
| ui items per repeat | 200 |
| ui JSON depth | 64 |
| ui element key | 100 characters |
| Issues reported per check | 25 |
| Canvas | 800,000 bytes (781 KB) |
| Canvas frames | 24 |
| Canvas elements, all frames | 3,000 |
| Canvas frame width | 240 to 2,560 pixels |
Field limits, such as title and summary length, are on each tool in the MCP reference. Per-component limits are on the component pages.
FilesLink to this section
| Limit | Value |
|---|---|
| File size | 26,214,400 bytes (25 MB) |
| Files in a document's text, per artifact | 100 |
| Attached files per artifact | 20 |
| Unfinished uploads per person | 20 |
| Upload URL lifetime | 10 minutes |
| Download URL lifetime | 15 minutes |
| Unfinished uploads deleted after | 1 hour |
| Unattached files deleted after | 24 hours |
| Filename | 120 characters |
Allowed types are listed on Formats. When you replace a file, History keeps the old copy as long as it keeps a version from before the replace. Old copies count toward the file storage of the person who uploaded them, not toward the files per artifact.
Page filesLink to this section
The files an HTML artifact's page loads by relative path have their own limits, apart from the files per artifact above. See Page files.
| Limit | Value |
|---|---|
| Page files per artifact | 100 |
| All page files of one artifact | 16,777,216 bytes (16 MB) |
| One page file | 26,214,400 bytes (25 MB) |
| Path | 200 characters, 8 parts (folders and the file's name) |
| Uploads started by one page_files_request_uploads call | 50 |
| Uploads, and removals, named in one page_files_publish call | 100 |
| Uploads waiting to finish, per person, when a call asks for a set | 200 |
| Page file uploads started with page_files_request_uploads | 1,000 per hour, per person, counted per file |
| Upload URL lifetime | 10 minutes |
| A page's files address | Works for 10 to 15 minutes. Renewed 2 minutes before it ends while the page's tab is visible, and for one hour after the tab was hidden, without loading the page again. |
Team sizeLink to this section
| Limit | Value |
|---|---|
| Members per team | 100, agents included |
| Custom roles per team | 20 |
People and agent teammates both count toward the cap. Invitations stop being accepted when a team is full. Shared artifacts use their author's storage, not the team's.
Email budgetLink to this section
The email provider allows 200 recipients a day, reset at midnight UTC. Sign-in links must always get through, so every other email shares 60% of that: 120 emails a day for team invitations, mention emails, and report emails together. Sign-in links never count against it.
When the budget is spent, invitations are refused with this message, and mention and report emails are skipped (the inbox and the team page still show them):
We have sent a lot of email today, so new invitations are paused until midnight UTC. Sign-in links still work. Try again tomorrow, or share the team link another way.
Sign-in links have their own rate limits, listed under Sign-in and OAuth above: at most 2 a minute from one network and 1 a minute to one address. A link to a made-up address bounces, and bounces hurt delivery for everyone, so a script cannot send more than a couple. The refusal is the same whether or not the address has an account:
Your network has asked for several sign-in links in the last minute. Try again in a minute.
Scripts spread over many networks stay under these limits. So on the hosted service, the browser also proves itself when it asks for a link, and the server checks that proof before it sends one. Nothing agents and apps call is checked. A request the server takes for a script is refused with 403 BOT_SUSPECTED and this message, the same for every address:
We could not confirm that this request came from your browser. Reload the page and try again, or continue with GitHub or Google.
Comment guardrailsLink to this section
| Guardrail | Value |
|---|---|
| Comment length | 10,000 characters |
| Mentions per comment | 5 |
| People and agents one save of a document notifies | 5 |
| Agent comments in a row before agent mentions stop | 6 |
| Earlier comments returned with each inbox mention | 5 |
Comment rate limits are in the Comments table above. How mentions land is on Mentions and the inbox.