Skip to main content
POST
Hand the screen a goal

Authorizations

Authorization
string
header
required

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

Headers

x-anthropic-api-key
string
required

The Anthropic API key the run calls Claude with.

Path Parameters

sandboxId
string
required

A sandbox id, sbx_….

Body

application/json
goal
string
required

What should be true when the run is done, like "TextEdit has a document saved as ~/Desktop/note.rtf that says hello". At most 4,000 characters.

Required string length: 1 - 4000
maxSteps
integer
default:30

Model turns the run may take; one turn may carry several actions.

Required range: 1 <= x <= 100
maxDurationMs
integer
default:600000

How long the run may take.

Required range: 10000 <= x <= 1800000
model
enum<string>

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

Response

The run ended within the hold.

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.