Skip to content

Conversation

@cellomatt
Copy link
Contributor

Description

This PR adds a section to the batch function page that provides guidance on what data is available after a batch step.

@linear
Copy link

linear bot commented Jan 13, 2026

@vercel
Copy link

vercel bot commented Jan 13, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
docs Ready Ready Preview, Comment Jan 13, 2026 10:29pm

@cellomatt cellomatt requested review from a team, bceskavich and cjbell January 13, 2026 22:19
@cellomatt cellomatt marked this pull request as ready for review January 13, 2026 22:19

### The `data` payload

When a workflow includes a batch step, the `data` payload that is available to your message templates after the batch window closes (and via the API, wherever trigger data is returned alongside a message or used as a [filter](/api-reference/overview/trigger-data-filtering)) will be combined and truncated according to the following rules:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm wondering if it would it make sense to split out the parenthetical, since this section is focused on using the data in templates? I like that you mention it (it's helpful info!) but wondering if it may fit better elsewhere?

Copy link
Contributor Author

@cellomatt cellomatt Jan 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm open to other ideas on where to put this, the reason I included it here was to make the connection between the message templates/steps and the messages that they ultimately produce. I suppose we could say "...alongside the message" and that might make that connection clearer?

It's also included in the API ref under trigger data filtering but I thought it might be good to have somewhere on the batch function page since that's the case where it's relevant within the workflow run.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants