startDesktopLiveSession
Start a live desktop browser testing session in the TestingBot cloud. Pass a tunnel ID to test localhost or private-network URLs through an active TestingBot Tunnel.
Instructions
Convenience tool to start a desktop browser live testing session. Automatically sets platformType to 'desktop'. For localhost / private-network URLs, pass the tunnelId of a running tunnel (startTunnel).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"desiredURL": "<desiredURL>",
"desiredOS": "<desiredOS>",
"desiredOSVersion": "<desiredOSVersion>",
"desiredBrowser": "<desiredBrowser>"
},
"name": "startDesktopLiveSession"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tunnelId | No | Numeric ID of a running TestingBot Tunnel (from startTunnel or getTunnelList) to route the session through. Needed for localhost / private-network URLs. | |
| desiredOS | Yes | Operating system (Windows, Mac, or Linux) | |
| desiredURL | Yes | The URL to open in the browser | |
| desiredBrowser | Yes | Browser name | |
| desiredOSVersion | Yes | OS version (e.g., '11', '13', 'Monterey') | |
| desiredBrowserVersion | No | Browser version or 'latest' (default: latest) | latest |