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 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.

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.

Studio canvas example for the wait for queue item block: typical wiring for wait for queue item.

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