Control Flow

Utility Control Nodes Reference

Technical reference for `wait`, `aggregate`, and `zip`, including output shape and downstream usage.

Updated 2 min read

Overview

These helper nodes are small but useful building blocks:

  • wait pauses execution.
  • aggregate computes summary statistics over arrays.
  • zip packages files into a single archive.

Configuration / Settings

NodeSettingDetails
waitdurationMilliseconds to pause.
aggregatenumericFieldOptional field used to compute sum, avg, min, and max.
zipnoneUses original filenames when building the archive.

Inputs Expected

  • wait accepts any payload and returns it unchanged.
  • aggregate expects an array but will wrap a single item.
  • zip expects one or more file blobs.

Variables Exported / Outputs

NodeOutput shapeExample
waitsame as inputUse it to throttle a branch without changing payload shape.
aggregate{ stats, data }{{aggregate_node.stats.count}}, {{aggregate_node.stats.sum}}
zipFile[]A single archive.zip file wrapped in an array.

Common Use Cases

  • Delay an outbound webhook or email.
  • Summarize spreadsheet rows before creating a report email.
  • Collapse many generated files into one archive before download or Gmail send.

Edge Cases

  • aggregate only computes numeric summaries when the chosen field can be parsed as numbers.
  • zip ignores non-blob inputs.
  • zip always names the output archive.zip in the current executor.