Past a size limit the request is refused with a 400 or 413. Past a count or
rate limit, it's a 409 or 429 with Retry-After. See Errors
for what to do about each. KiB = 1,024 bytes, MiB = 1,024 KiB.
Agents
Limit
Value
An agent's key
1 to 80 characters of A-Z a-z 0-9 _ -
Lifetime (ttlSeconds)
60 seconds to 366 days, or null for until deleted. Default: until deleted with a key, 1 day without
Imported history (initialMessages)
16 MB of JSON
systemPrompt, systemPromptAppend
32,000 characters each
modelHeaders
20 headers, 8 KB in all
context
4 KB
Mounts
16 per agent
Agents busy at once
By usage tier, across the whole runtime. An agent is busy while it has a run open, running or queued; a busy agent queues more runs without another slot. A run past the limit gets 429 BUSY_AGENT_LIMIT
Tools in an agent's catalog
4,096 tools and 16 MiB of schemas; at most 64 offered directly to the model, the rest reached from js_exec
Usage tiers
An account's tier comes from what it has paid for credit in total, net of
refunds. Starting credit and other grants do not count. A payment moves the
account up as soon as it lands. See Pricing.
Tier
Paid in total
Agents busy at once
Free
nothing yet
8
Tier 1
$5
25
Tier 2
$50
100
Tier 3
$250
250
Tier 4
$1,000
1,000
GET /v1/billing has busyAgents: the limit, how many are busy now, the tier,
and the next one; the console's Billing page shows the same.
Runs and requests
Limit
Value
Request id (requestId, idempotencyKey)
1 to 80 characters of A-Z a-z 0-9 _ -
Open requests per agent (running and queued)
32
Prompt body
6 MiB, with inline files
metadata
16 keys of 1 to 64 characters, string values of at most 512 characters
Provider retries within a turn
3 attempts for overloads, rate limits, 5xx and dropped streams
How long a run may take
No limit. The SDKs have no default timeout
Idempotency-Key header
1 to 255 characters; its answer is kept for 24 hours
Files
Limit
Value
Files attached to one message
20
Inline (base64) file bytes in one message
4 MiB in all
One file
256 MiB
Image the model sees natively
5 MiB and 8,000 pixels a side
PDF the model sees natively
16 MiB and 100 pages
Signed links
1 second to 24 hours, default 15 minutes
A volume
100,000 files and 100 snapshots
Tools
Limit
Value
A tool result the model reads
32,000 characters; a longer one is saved whole to a file the model can read
Attached tool call deadline
15 seconds without an answer by default; timeoutMs from 1 second to 20 minutes
MCP server call deadline
Default 60 seconds, at most 20 minutes
OpenAPI operation deadline
Default 30 seconds, at most 20 minutes
Progress
Each progress report restarts a call's deadline, up to 20 minutes in all
One tool result from the SDKs
1 MiB of JSON
Tool sources per definition
64 MCP servers and 64 OpenAPI specs
An OpenAPI spec
8 MiB, at most 1,024 operations
Code the model writes (js_exec)
Limit
Value
Wall time
30 seconds by default, at most 120
CPU time
2 seconds of executing code (time waiting on tools doesn't count)
