Skip to main content
Workflows can run synchronously (the caller waits for completion) or asynchronously (the caller gets an 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

Sync execution

Success response:
Failure response:

Async execution

Immediate response:
Poll for the result: