Block until the job reaches terminal status, or until timeout
Synchronously wait for a job to terminate. Useful for shell scripts and simple HTTP clients that can’t consume SSE…
POST
Synchronously wait for a job to terminate.
Useful for shell scripts and simple HTTP clients that can’t consume
SSE. Returns immediately when the job is already in a terminal
status; otherwise blocks up to
timeout_seconds (default 30, max
60) before returning the current state with is_terminal: false.
Implementation: server-side polling on a 1-second interval,
refreshing the row each tick. Avoids holding an open broker
subscription so connection-pool pressure stays bounded — the
long-running idiom is /events/stream (SSE) when you need
intermediate updates rather than just terminal status.
Path parameters
string (uuid)
required
Request body
JSON body of typeWaitJobRequest,null.
Response
WaitJobResponse
string
required
string
required
boolean
required
True if the job reached
succeeded/failed/cancelled before the timeout. False means the timeout fired and the returned status is still in-flight.number
required
Wall-clock seconds spent blocking inside the handler.
string,null
string,null
number,null