Foreach
Written by
Updated at May 12, 2025
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 is supported | Description |
|---|---|---|---|---|---|
input |
string |
Yes | No | Yes | A jq expression that forms an array of objects. If the result is not an array of objects, the run will be terminated with an error. |
output |
string |
Yes | No | Yes | A jq expression that forms an object to contain the foreach output. If the result is not an object, the run will be terminated with an error. |
do |
ForeachDo | Yes | No | No | Sequence of steps to apply to each input data item. |
concurrency |
int |
No | 1 | No | Number of input data items on which the sequence of steps from do is being performed at the same time. |
next |
string |
No | No | No | 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. |