Skip to content

Commit 9cbb9d0

Browse files
committed
docs(limits): document automatic payload offloading for triggers and batches
Clarify that large payloads and outputs are offloaded to object storage transparently. Split the behaviour into the send path (SDK uploads any trigger or batch-item payload over 128KB before sending, single trigger since 4.5.0 and batch since 4.5.2) and the retrieve path (payloads/outputs over 512KB returned as a presigned URL from runs.retrieve).
1 parent 1a0198c commit 9cbb9d0

1 file changed

Lines changed: 5 additions & 1 deletion

File tree

docs/limits.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,11 @@ Additional bundles are available for $10/month per 100 concurrent connections. C
104104
| Batch trigger payload | Each item can be up to 3MB (SDK 4.3.1+). Prior: 1MB total combined |
105105
| Task outputs | Must not exceed 10MB |
106106

107-
Payloads and outputs that exceed 512KB will be offloaded to object storage and a presigned URL will be provided to download the data when calling `runs.retrieve`. You don't need to do anything to handle this in your tasks however, as we will transparently upload/download these during operation.
107+
Large payloads and outputs are offloaded to object storage automatically. You don't need to do anything to handle this in your tasks, as we upload and download the data transparently during operation.
108+
109+
On the way in, the SDK uploads any trigger or batch-item payload over 128KB to object storage before sending, so large triggers and batches don't exceed the request body limit. `trigger` and `triggerAndWait` have done this since SDK 4.5.0, and `batchTrigger` and `batchTriggerAndWait` (including the by-id and by-task variants) do too from SDK 4.5.2.
110+
111+
Payloads and outputs over 512KB are kept in object storage rather than inline. Calling `runs.retrieve` returns that offloaded data as a presigned download URL (`payloadPresignedUrl` / `outputPresignedUrl`).
108112

109113
## Batch size
110114

0 commit comments

Comments
 (0)