Async Job Roundtrip

Acknowledgement, queueing, background work, retries, callback, polling, and final consistency

Async Job Roundtrip Acknowledgement, queueing, background work, retries, callback, polling, and final consistency Accept Background work Notify + reconcile POST /jobs enqueue job 202 + job id deliver perform work result / timeout retry if timeout persist final state job.completed signed webhook GET /jobs/:id read status completed 200 final result Client · mobile app · Sequence participant Client mobile app Jobs API · request edge · Sequence participant Jobs API request edge Queue · durable work · Sequence participant Queue durable work Worker · background · Sequence participant Worker background Provider · external API · Sequence participant Provider external API Job Store · source of truth · Sequence participant Job Store source of truth Notifier · webhook · Sequence participant Notifier webhook Legend request return security async trace

Fast Acknowledgement

  • • The caller receives a durable job id before work begins
  • • Queue ownership is visible in the acceptance contract
  • • The original connection does not wait for provider latency

Bounded Recovery

  • • Timeouts re-enter the queue with a retry policy
  • • Final state is persisted before notification
  • • The job store remains the source of truth

Two Observation Paths

  • • A signed webhook announces completion
  • • Status polling is a fallback, not a second workflow
  • • Both paths converge on the same final state

Sequence diagram • Built with Archify • Hover to trace • R route • Click to focus • +/− zoom • M radar • [/] views • P play story • T theme • E export