GuidesNodes
Wait
Pause graph execution for a fixed or dynamically computed duration.
Wait nodes pause graph execution for a specified duration before allowing downstream nodes to continue. Use them for rate limiting, timed delays, or waiting for external systems to complete processing.
Configuration
Configure either a fixed duration (using amount and unit) or a dynamic duration (using secondsFromConfig). Do not set both.
| Field | Type | Required | Description |
|---|---|---|---|
| amount | number | No | The numeric value of the delay. Used together with unit to define a fixed duration (for example, 5 with unit: "minutes" pauses for five minutes). |
| unit | string | No | Time unit for the fixed delay: seconds, minutes, hours, or days. Must be set when amount is provided. |
| secondsFromConfig | string | No | A placeholder or expression that resolves to a number of seconds at runtime. Use this when the delay duration is dynamic -- for example, {{input.delaySeconds}}. |
Input
The node receives the trigger payload and upstream node outputs. When using secondsFromConfig, placeholders can reference upstream data to compute the delay dynamically.
Output
After the wait completes, the node passes the input context (trigger payload and upstream outputs) through to downstream nodes unchanged. No additional data is produced.
Tips
- Use a fixed duration (
amount+unit) when the delay is known ahead of time -- for example, waiting 30 seconds between API calls for rate limiting. - Use a dynamic duration (
secondsFromConfig) when the delay depends on runtime data -- for example, a retry interval computed by an upstream Code node. - Wait nodes are non-blocking at the platform level. The execution is paused and resumed by the runtime; other graph executions are not affected.
- Be mindful of platform execution time limits when configuring long waits. For recurring tasks, consider using a Schedule trigger instead of a long in-graph delay.
Related
- Schedule triggers -- Run graphs on a recurring schedule instead of pausing within a graph.
- Switch -- Branch after a wait for retry or timeout logic.
- Code -- Compute a dynamic wait duration before the wait node.