wait for queue item

This block is part of the queue group and was last modified in core v15.0.0.

wait for queue item condition v15.0.0

Polls a queue document by GUID and blocks the flow until the job reaches a terminal state (executed/failed) or the timeout elapses. Use with any block that produces a queue_guid outpin (e.g. video_compress with wait_in_flow=false) to gate downstream work on background completion.

In pins 2 + flow

flow
flow
queue guid required
value
GUID of the queue document to wait on.
wait timeout (s)
number
How long to wait before giving up with WAIT_TIMEOUT.
Default 300

Out pins 4 + flow

flow
flow
success
condition
True when the queue job completed successfully.
state
value
Terminal state: executed, failed, timeout, or cancelled.
result
object
The executor's recorded result map. Empty when the executor didn't record one (e.g. blueprint-trigger jobs).
error
value
Failure reason when state != executed.

Blocks the flow, polling the queue document once per second, until its state is executed or failed; then outputs that state, the job's recorded result object, and success. success defaults to (state == executed) but a result map carrying its own success boolean overrides that. Giving up after wait_timeout_seconds (default 300) yields state=timeout with error WAIT_TIMEOUT; a cancelled flow yields state=cancelled. Empty queue_guid fails immediately with error MISSING_QUEUE_GUID.

wait for queue

queue wait

await queue

A typical wiring for wait for queue item: a function trigger starts the flow; value feeds the queue_guid pin; the flow out pin feeds debug.

Version history

Introduced in v15.0.0.

Back to queue Return to the main group to view all sub-groups Back to function Return to the group to view all blocks within this group