Skip to main content
Any action whose steps[] includes browser_use must declare executionMode: async on the action. The runtime enforces this — a sync action containing browser_use fails schema validation at build time.

Input

FieldDescriptionTypeRequired
authCredential handling for the browser task.objectNo
budgetsExecution limits the task must run within.objectYes
localeLocale the browser session runs in.stringNo
startUrlURL where the browser session begins.
Format: uri
stringYes
systemPromptAuthor-defined preamble, persona, and guardrails applied to every invocation.stringNo
viewportBrowser viewport dimensions.objectNo
Credential handling for the browser task.
FieldDescriptionTypeRequired
allowedDomainsOverrides the default allowed-domains policy, for auth flows that cross a domain boundary.string[]No
requiresSessionReserved for tasks that need a pre-authenticated browser session rather than form substitution. Not yet in use.booleanNo
sensitiveKeysCredential keys masked from the LLM and substituted only at the typing layer.string[]No
Execution limits the task must run within.
FieldDescriptionTypeRequired
maxDurationMsMaximum task duration in milliseconds.integerYes
maxStepsMaximum number of steps the agent may take.integerYes
Browser viewport dimensions.
FieldDescriptionTypeRequired
heightViewport height in pixels.integerYes
widthViewport width in pixels.integerYes

Output