Skip to main content
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.
Supply exactly one of task or workflow. Do not place secrets in the task, resolved workflow, or metadata.

Response

uuid
required
Durable run identifier.
string
required
Usually queued or running on acceptance.
string
required
modal for public cloud runs.
Poll Get a run or use an SDK wait helper until the run is terminal.
Last modified on August 16, 2026