Step reference

A workflow is an ordered list of steps. Each step is a small JSON object with a type, and each one can read the output of the steps before it.

There are 30+ step types. They are grouped below by family; open any step for its fields, a working example and its behaviour.

Every step, by family

Navigation

Step	JSON type	What it does
Navigate	`navigate`	Load a URL in the live tab and wait for it to settle.
Navigated to	`navigated_to`	Recorded marker: the page itself navigated; replay waits for the expected URL.

Interaction

Step	JSON type	What it does
Click	`click`	Click an element identified by a stable selector.
Hover	`hover`	Move the pointer over an element to reveal hover-only UI.
Press key	`press`	Press a keyboard key or shortcut.
Focus	`focus`	Move keyboard focus to an element without clicking it.
Fill	`fill`	Set a field's value in one operation.
Type	`type`	Enter text keystroke-by-keystroke.
Select	`select`	Choose an option from a dropdown.
Check	`check`	Set a checkbox or radio to checked.
Uncheck	`uncheck`	Set a checkbox to unchecked.
Scroll	`scroll`	Scroll the page, e.g. to load lazy content.
Scroll into view	`scroll_into_view`	Bring a specific element into the viewport.
Upload file	`upload`	Attach a stored file to a file input or file chooser.

Waiting

Step	JSON type	What it does
Wait	`wait`	Pause for a duration or until a condition holds.
Wait for change	`wait_for_change`	Wait until watched page content changes.
Wait for download	`wait_for_download`	Wait for a file download to complete and capture the file.

Extraction

Step	JSON type	What it does
Extract	`extract`	Pull structured data out of the page into named fields.
Evaluate (JS)	`evaluate`	Run JavaScript in the page and capture its result.
Codegen	`codegen`	Run a self-contained generated script against the page.
Screenshot	`screenshot`	Capture the page as an image, stored with the run.
API call	`api_call`	Make an HTTP request from inside the page session.

Tabs

Step	JSON type	What it does
Open tab	`open_tab`	Open a new browser tab, optionally at a URL.
Wait for tab	`wait_for_tab`	Wait for a new tab to open, then switch to it.
Switch tab	`switch_tab`	Make a different open tab the active one.
Tab closed	`tab_closed`	Recorded marker: the active tab closed; replay closes it too.

AI

Step	JSON type	What it does
AI fill	`ai_fill`	Let the AI fill a field when a selector is not enough.
AI fill form	`ai_fill_form`	Let the AI complete a whole form from the available data.
AI continue	`ai_continue`	Let the AI decide and take the next actions toward a goal.
AI navigate	`ai_navigate`	Let the AI find and reach a described destination.

Authentication

Step	JSON type	What it does
Login (request)	`login_post`	Sign in as a request instead of a DOM form, on your own account.
Two-factor (2FA)	`twofa`	Complete a two-factor challenge on your own account.
Verification step	`captcha`	Complete an interactive verification on a page you are authorized to use.

Flow

Step	JSON type	What it does
Return	`return`	End the workflow here and return what has been collected.
End point	`end_point`	Mark the workflow's finish line, optionally behind a condition.
Assert	`assert`	Require the page to be in an expected state, or fail the run.

How steps get written

You rarely write these by hand. The recorder emits them while you click through the site, and Scribe emits them from a description in plain words. This page is for reading a workflow someone else built, and for editing one by hand when you need exact control.