name: dispatch-and-optimize
description: |
  Workflow capability for batched dispatch and route optimization on Onfleet.
  Creates many tasks asynchronously, kicks off route optimization for a team
  or vehicle pool, applies the result, and then drives any remaining
  unassigned work through Team Auto-Dispatch.
apis:
  - onfleet-tasks-api
  - onfleet-route-plans-api
  - onfleet-organizations-api
steps:
  - id: batch-create-tasks
    operation: createTaskBatch
    description: Asynchronously create up to 100 tasks at once.
  - id: initialize-optimization
    operation: initializeOptimization
    description: Queue a route optimization for the team/workers/time window.
  - id: poll-status
    operation: getOptimizationStatus
    description: Poll until the optimization job is COMPLETED.
  - id: apply-optimization
    operation: applyOptimization
    description: Materialize the optimization result as route plans assigned to workers.
  - id: auto-dispatch-remainder
    operation: teamAutoDispatch
    description: Run Team Auto-Dispatch on any unassigned tasks for the team.