docs(limits): document automatic payload offloading for triggers and batches

[1stvamp]

Summary

The limits page didn't spell out that large payloads offload to object storage automatically, and its single "512KB" note conflated two different thresholds. This clarifies the behaviour.

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 hit the request body limit (trigger / triggerAndWait since 4.5.0, batchTrigger / batchTriggerAndWait since 4.5.2). On retrieval, payloads and outputs over 512KB are stored in object storage and returned as a presigned URL from runs.retrieve.

[changeset-bot]

⚠️ No Changeset found

Latest commit: 58844be

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[coderabbitai]

Walkthrough

Updated the limits documentation to explain automatic offloading of large payloads and outputs, SDK pre-upload behavior for payloads over 128KB, applicable SDK versions, and presigned download URLs for retrieved data over 512KB.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The description is missing the required issue link, checklist, testing, changelog, and screenshots sections.	Add the template sections: Closes #issue, checklist, testing steps, changelog, and screenshots, with each filled out.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Title check	✅ Passed	The title clearly summarizes the docs change about automatic payload offloading for triggers and batches.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/limits-batch-payload-offload

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

[pkg-pr-new]

Open in StackBlitz

@trigger.dev/build

npm i https://pkg.pr.new/@trigger.dev/build@58844be

trigger.dev

npm i https://pkg.pr.new/trigger.dev@58844be

@trigger.dev/core

npm i https://pkg.pr.new/@trigger.dev/core@58844be

@trigger.dev/python

npm i https://pkg.pr.new/@trigger.dev/python@58844be

@trigger.dev/react-hooks

npm i https://pkg.pr.new/@trigger.dev/react-hooks@58844be

@trigger.dev/redis-worker

npm i https://pkg.pr.new/@trigger.dev/redis-worker@58844be

@trigger.dev/rsc

npm i https://pkg.pr.new/@trigger.dev/rsc@58844be

@trigger.dev/schema-to-json

npm i https://pkg.pr.new/@trigger.dev/schema-to-json@58844be

@trigger.dev/sdk

npm i https://pkg.pr.new/@trigger.dev/sdk@58844be

commit: 58844be