Skip to main content

​
How it works

  • over must produce a list. The body (do) runs once per item, with {{item}} and {{index}} available.
  • concurrency runs that many items at once. Use it only when items don’t depend on each other.
  • onError: skip leaves failed items out of results and lists them in failed, with failed_count, instead of failing the plan.

​
Limits

  • The body can contain agent, ask, filter, route and exit, but not another map or reduce. Call a plan for nested iteration.
  • ask steps in the body run one item at a time.

​
Input

​
integer
Maximum items in flight; 1 (default) runs items one at a time.
​
object | object[]
required
​
enum<string>
fail (default): a failing item fails the step. skip: failed items are left out of results and listed in failed.Available options: fail, skip
​
any
required
The list to iterate — usually a template like {{E0.issues}} that resolves to an array.

​
Result

Later steps read these as {{<step id>.<field>}}.
​
integer
How many items ran.
​
object[]
With onError: skip: the items that failed.
​
string
Why it failed.
​
integer
The failed item’s position in the list.
​
object
The failed item.
​
integer
With onError: skip: how many items failed.
​
object[]
Each item’s result, in input order.