Create a run
Browser runs
Create a run
Start one free-form browser task or one ordered workflow.
POST
Create a run
Requires
runs:write. Returns 202 Accepted when the run is durably queued.
string
Stable mutation key containing 1–255 printable ASCII characters without spaces. Strongly recommended.
string
Free-form browser goal. Required when
workflow is omitted. Maximum 20,000 characters.object
Version 1 ordered workflow. Required when
task is omitted. Maximum 100 steps and 128 KB.object
Application-defined correlation metadata. Maximum 16 KB. Defaults to an empty object.
Response
uuid
required
Durable run identifier.
string
required
Usually
queued or running on acceptance.string
required
modal for public cloud runs.Last modified on August 16, 2026