Skip to main content
Live. This area is documented as current, user-reliable behavior.

​
Goal

Debug Durable Jobs without guessing where the run stopped.

​
Prerequisites

  • At least one Durable Jobs run

​
Workflow

1
Open the run from the Durable Jobs page.
2
Check status and attempts first.
3
Read the timeline to see which step completed, failed, or started waiting.
4
Use logs and error details to fix the underlying issue.

​
What to inspect

  • Status: queued, running, waiting, completed, failed, or canceled.
  • Attempts: how many times StackShift has invoked the handler.
  • Logs: handler output and platform events.
  • Timeline: step completion, waiting state, event receipt, retries, and final result.

​
Example timeline

Onboarding run
[done] create-user
[done] send-email
[waiting] waiting for email.verified
[done] event received
[done] unlock-account

​
Check status from code

Fetch a run
const run = await stackshift.getRun('run_123')

console.log(run.status)
console.log(run.attempts)
console.log(run.waiting_for_event)

​
Expected result

You can answer whether a job is queued, running, waiting, completed, failed, or canceled.

Retries & Failure Handling

Durable Jobs retries transient failures, preserves completed steps, and gives failed work a clear recovery path.