Skip to main content
GET
Follow a run

Authorizations

Authorization
string
header
required

A team API key, sk_offstage_…, created in the console. Everything it touches belongs to its team.

Path Parameters

runId
string
required

A run id, run_…, from runAgent.

Query Parameters

wait
number

Seconds to hold the answer while the run is under way.

Required range: 0 <= x <= 60

Response

The run has ended.

A goal handed to a gui sandbox, and what came of it.

id
string
required
Pattern: ^run_
sandboxId
string
required
Pattern: ^sbx_
goal
string
required
maxSteps
integer
required
maxDurationMs
integer
required
model
enum<string>
required

The Claude model a run calls: one with the computer toolset.

Available options:
claude-opus-5-5,
claude-sonnet-5-5,
claude-haiku-5-5,
claude-fable-5-1,
claude-opus-5
state
enum<string>
required
Available options:
running,
finished
startedAt
integer
required

A time, in Unix milliseconds.

Required range: x >= 0
steps
object[]
required
frames
integer
required

Screenshots the run's recording holds.

Required range: x >= 0
endedAt
integer

A time, in Unix milliseconds.

Required range: x >= 0
verdict
enum<string>

done and failed are the model's own verdict; incomplete means its steps or time ran out, or it broke first (see error).

Available options:
done,
failed,
incomplete
reason
string

The model's account of the verdict, or why the run ended without one.

error
object

Set when the run broke rather than ended: the harness failed, the sandbox closed.

replayUrl
string

Its sandbox's replay in the console, where this run's steps play back against the screen: present when the sandbox records.