Actions44
- Execution Actions
- Monitoring Actions
- Scheduler Actions
- Tag Actions
- Workflow Actions
Execution → Live Execution Polling
AI-generatedSummary
Polls a single n8n execution via the n8n public API until it reaches a terminal status or the poll-cycle limit is hit, then returns the last fetched execution and a per-poll status history.
Inputs
- executionId (required) — The execution to watch. Choose from the recent-executions list (the 5 most recent pages of executions, cached ~30s) or supply an ID via expression. An empty value throws 'Enter an execution ID.'
- pollIntervalSeconds — Seconds to wait between status checks. Default 5, range 1–60.
- maxPollCycles — Maximum number of status checks. Default 24, range 1–120 (capped at 120 in code). With defaults, this waits about 2 minutes.
Output shape
One output item per input item, with json: { executionId, finalExecution, pollHistory }. pollHistory is an array of { cycle, status, checkedAt } entries, one per check.
Polling stops early when status is success, error, canceled, crashed or failed. If the execution is still running or waiting after the last cycle, the node does not error. It returns the latest snapshot, so check finalExecution.status or the last pollHistory entry. Execution data is not included (includeData=false), only metadata such as status, timestamps and workflow info. Status falls back to 'success' if the execution is finished and 'running' otherwise when no status is present. The node sleeps for the full interval between checks, so it holds the workflow run open. It needs an n8nApi credential. API calls retry up to 3 times on 408/425/429/5xx errors. With Continue On Fail enabled, errors come back as { error } items.
Examples
Example 1: Wait for a long-running execution started elsewhere to finish before continuing downstream.
executionId = {{$json.executionId}}, pollIntervalSeconds = 10, maxPollCycles = 60
Example 2: Quick check that an execution completes within about 2 minutes, then branch on its final status.
Defaults (5s interval, 24 cycles), then an IF node on {{$json.finalExecution.status}}