Foreach
Written by
Updated at August 18, 2026
Note
Currently, there are two UIs that support Workflows: Yandex Cloud and Yandex AI Studio. In this case, the following applies:
- Workflows created in the Yandex Cloud UI are automatically available in the AI Studio UI.
- Workflows created in the AI Studio UI are not available in the Yandex Cloud UI.
Starting September 3, 2026, Workflows will no longer be supported in the Yandex Cloud UI. To create and manage workflows, use the AI Studio UI.
Executes the sequence of steps specified in do on each input data item. Outputs are an array of execution results of the steps specified in do. For steps from do, in the next field, you can only specify steps listed in do. Read more about the workflow state during the Foreach step.
| Field name | Type | Required | Default value | Templating supported | Description |
|---|---|---|---|---|---|
input |
string |
Yes | None | Yes | jq template that forms an array of objects. If the result is not an array of objects, the execution will terminate with an error. |
output |
string |
Yes | None | Yes | jq template that forms an object with the foreach output. If the result is not an object, the execution will terminate with an error. |
do |
ForeachDo | Yes | None | None | Sequence of steps to apply to each input data item. |
concurrency |
int |
None | 1 | None | Number of input data items on which the sequence of steps from do is being performed at the same time. |
next |
string |
None | None | None | ID of the next step. |
ForeachDo object
| Field name | Type | Required | Description |
|---|---|---|---|
start |
string |
Yes | ID of the step to start the execution from. |
steps |
map<string, Step> |
Yes | Description of the steps. Object where key is the step ID, and value is the object describing the step parameters. The structure is similar to the steps field in the high-level specification. |