Open Browser Window
airtop.create_window
ActionBusiness appsconnection required
Calls the Airtop API with the connection's credentials.
Open a browser window in a session, optionally loading a URL.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- Bearer token
- Providers
- Airtop
- Secret shape
- the API key, or {"api_key": "…"}
- Config it needs
- base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
5 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
session_id The session id returned by airtop.create_session. | string | Yes | — | — | 6aac6f73-bd89-4a76-ab32-5a6c422e8b0b |
url The page to load in the new window. Leave blank to open a blank window. | string | No | — | url format | https://example.com |
wait_until Which loading event to wait for: 'load' waits for the DOM and its assets, 'domContentLoaded' only for the DOM, 'complete' also for every iframe, and 'noWait' returns immediately. | string | No | load | one of "load", "domContentLoaded", "complete", "noWait" | — |
wait_until_timeout_seconds How long to wait for that loading event before giving up. | number | No | — | ≥ 0 | — |
screen_resolution Fixed dimensions for the window's live view, such as 1280x720. Leave blank to let the live view size the window. | string | No | — | — | 1280x720 |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"screen_resolution": "1280x720",
"session_id": "6aac6f73-bd89-4a76-ab32-5a6c422e8b0b",
"url": "https://example.com",
"wait_until": "load"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
session_id The session the window belongs to. | string | — |
window_id The Airtop window id; every page node needs it. | string | — |
target_id The window's Chrome DevTools Protocol target id. | string | — |
url The URL the window was opened at, if one was given. | string | — |
warnings Non-fatal problems Airtop reported opening it. | array | — |
{
"session_id": "",
"target_id": "",
"url": "",
"warnings": [],
"window_id": ""
}Notes
- An Airtop session is a live cloud browser and bills for as long as it runs: end it with airtop.terminate_session, and set timeout_minutes as a backstop.
See Open Browser Window run in a workflow.
In a technical demo we add the Airtop connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.