Function: experimental.executions.map

Caution: The behavior of this routine might change, and it might not besupported in the future.Note: Instead of usingexperimental.executions.map to support parallel work,we recommend youexecute workflow steps in parallel.If you are already usingexperimental.executions.map, you canmigrate your workflow to use parallel steps.

Starts workflow executions and waits for all of them to finish.

Arguments

Arguments
workflow_id

string

ID of the workflow.

argumentsList of optional execution parameters. A workflow execution is created for each element of the list.
timeout

float

The request timeout, in seconds (default:1800.0). If the request takes longer than the timeout, aTimeoutError is raised.

location

string

If present, location of the workflow. The location of the caller is used by default.

project_id

string

If present, project ID associated with the workflow. The project ID of the caller is used by default.

Returns

A list where each element is the result of a workflow execution starting and a corresponding argument.

Raised exceptions

Exceptions
ExecutionErrorIf any of the executions finish unsuccessfully.
TimeoutErrorIf waiting for the executions to finish takes longer than the specified timeout limit.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.