Limits

These are the hard limits that bound a single play run. They protect the platform (and your run) from runaway resource use, so a misbehaving play fails fast with a clear error instead of hanging or starving other work.

These values are generated directly from the runtime source, so this page is always current. Need a higher limit for a specific workload? Get in touch — most are raised per workspace.

Submit & input

Limit	Value	What it means
Inline input file size	`64 KiB`	Largest CSV/file input that can be sent inline with a run submission. Bigger inputs must be staged with `plays files stage` and passed by handle.
Inline submission threshold	`100 KB`	Submitted input at or below this size stays inline in coordinator state. Above it (up to the hard ceiling) the input is externalized to a short-lived artifact automatically.
Maximum submitted input	`1 MiB`	Absolute ceiling on a single submission’s input/retry state. Larger payloads must use staged files or `ctx.csv` inputs.
Synchronous wait ceiling	`15 s`	How long the run endpoint blocks for a synchronous result before returning a pending handle to poll or stream.

Bundle & compile

Limit	Value	What it means
Compiled play bundle (hard cap)	`30 MiB`	Absolute ceiling on a compiled CJS play bundle, enforced at submit time.

Revision storage

Limit	Value	What it means
Persisted play revision metadata	`1 MB`	Maximum Convex-encoded size of one saved play revision, including source, static pipeline, bindings, and metadata. This is separate from the compiled bundle limit.

Run duration

Limit	Value	What it means
Standard play runtime	`30 min`	Default maximum active user-code runtime. Set a static Play-level runtime.timeout such as 90m or 2h for a bounded batch, up to 4h.

Inline composition & budgets

Limit	Value	What it means
Inline composition depth	`8`	Maximum nesting depth for inline `ctx.runPlay(...)` composition. It prevents accidental recursion; `ctx.runPlay` never creates a child run.
Tool-call budget	`5,000,000`	Total `ctx.tool(...)` call budget for a play invocation.

Concurrency

A play run has two independent concurrency layers: map rows (how many rows of a ctx.dataset().map(...) resolve at once) and external calls (provider tools and ctx.fetch; extra calls wait rather than fail). Map rows use a library default of 20 and accept a run-wide default/ceiling from 1 through 1000. External calls default to 64 and accept 1 through 256. Authored map concurrency, byte admission, provider pacing, and sandbox memory can tighten the effective values. Inline ctx.runPlay(...) shares both run limits.

Limit	Value	What it means
Map row concurrency ceiling	`1,000`	Maximum run-wide live map-row setting. Set 1 through 1000 with maxConcurrentRows or —max-concurrent-rows. When unset, maps use the library default unless the Play declares a lower concurrency. Authored concurrency, source-row byte admission, and sandbox memory may lower the effective value. Pure-compute maps use a separate fast path.
Concurrent external calls (default)	`64`	Default global backstop on concurrently resident provider-tool and ctx.fetch executions within a play run. Set 1 through 256 with maxConcurrentExternalCalls or —max-concurrent-external-calls. A call keeps its slot through durable receipt settlement; extra calls wait rather than fail. Provider pacing and the hard runner ceiling still apply.

Output & logs

Limit	Value	What it means
Play return	`5 MiB`	Maximum serialized size of the complete value returned by a play. Arrays have no row-count limit within this byte budget; larger returns fail with OUTPUT_TOO_LARGE instead of being silently truncated.

Runtime sheet

Limit	Value	What it means
Sheet viewport max rows	`5,000`	Maximum rows returnable by a single (non-live) sheet viewport read.

Getting Started

GTM is code

Features

Deepline SDK beta

Integrations

API Reference

Submit & input

Bundle & compile

Revision storage

Run duration

Inline composition & budgets

Concurrency

Output & logs

Runtime sheet

​Submit & input

​Bundle & compile

​Revision storage

​Run duration

​Inline composition & budgets

​Concurrency

​Output & logs

​Runtime sheet

Submit & input

Bundle & compile

Revision storage

Run duration

Inline composition & budgets

Concurrency

Output & logs

Runtime sheet