Limits
Request-size limits, and the rate limits of the MCP server and OAuth client registration.
Size limits
These limits apply to the live machine API.
| Type | Limit |
|---|---|
| JSON request body | 16,384 bytes |
| JSON request body of Search objects and Read spans | 4 MiB |
| JSON request body of Answer a question and Start research | 6 MiB |
| JSON request body on the webhook routes | 1 MiB |
| Objects in keys (Search objects, Answer a question, Start research) | 50 keys |
| One key in keys, and keyPrefix | 1,024 characters |
| Spans in one Read spans call | 1 to 50 spans |
| Inline data in one Read spans call (a part past it comes back as a url) | 20 MiB |
| One part of one span in Read spans (a larger span comes back in parts, and next holds the rest) | 50,000 characters of text, 500 pages, or 600 seconds |
| Storage upload request (one PUT, or one multipart part) | 200 MiB |
| Invitation batch | 1 to 50 email addresses |
| MCP request body | 6 MiB |
| MCP inline object (write_object, replace_object, read_object) | 1 MiB |
| MCP tool result | 100,000 characters |
Rate limits
The HTTP API and the storage API set no rate limits in the beta. The MCP server and OAuth client registration do. A call over a limit gets the error rate_limited with retryAfterSeconds, or HTTP 429 for registration.
| Type | Limit |
|---|---|
| MCP tool calls | 300 a minute for each API key, and for each user signed in with OAuth |
| OAuth client registration (POST /oauth/register) | 10 an hour for each IP address |
Was this page helpful?