Skip to main content

wait_for_run

Block until the run finishes, polling at the server-recommended interval (normally 3 seconds), and return its results digest.

info

This is an MCP / CLI convenience — there is no REST wait endpoint. Over raw HTTP, poll GET …/runs/{runId} yourself. See Long-running operations.

Arguments​

ArgumentTypeRequiredDescription
runIdintegeryesThe run id from run_feature.
timeoutSecondsintegernoHow long to wait (default 120, max 170).
projectstringnoProject public id (defaults to the configured project).

Tool wait_for_run — { "runId": 214 }.

Result​

The same payload as get_run, taken when isTerminal becomes true — or at the timeout.

warning

Timing out cancels nothing. If isTerminal is false (queued, allocating, or running), call the tool again with the same runId.

monitoringInterrupted: true means a transient status read failed; it is not a completed result. Retry monitoring the same operation instead of dispatching it again. A wait can finish before the operation, so always check isTerminal on the returned payload.