execution_id immediately and the workflow runs in the background).
At a glance
When to use sync
- The caller needs the result immediately (agent tool during a live call)
- Total expected duration is well under 30 seconds
- No Wait steps
- Low-latency response matters
When to use async
- The workflow has Wait steps longer than a few seconds
- The workflow has a Loop step over more than a handful of items — iterations run one after another, so the time adds up
- The workflow has a Parallel step over more than 10 items — that is the sync ceiling; async allows 200
- Total duration could exceed 30 seconds
- Retry on failure matters
- The caller doesn’t need the result synchronously
- High-concurrency batch processing

