startLiveSession
Start an interactive TestingBot live testing session for desktop or mobile, returning a dashboard link to open and confirm. Use a tunnel ID for localhost or private-network URLs.
Instructions
Start an interactive live testing session on TestingBot. Returns a link that opens the session in the user's TestingBot dashboard (they confirm with Start). Supports desktop browsers (Chrome, Firefox, Safari, Edge, IE) and mobile emulators/simulators (Android, iOS). For localhost / private-network URLs, start a tunnel first (startTunnel) and pass its numeric ID as tunnelId.
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": {
"platformType": "<platformType>",
"desiredURL": "<desiredURL>",
"desiredOS": "<desiredOS>",
"desiredOSVersion": "<desiredOSVersion>"
},
"name": "startLiveSession"
}
}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', 'Linux' for desktop; 'android', 'ios' for mobile | |
| desiredURL | Yes | The URL to open in the browser | |
| platformType | Yes | Platform type: 'desktop' for desktop browsers or 'mobile' for mobile devices | |
| desiredDevice | No | Device name for mobile (e.g., 'iPhone 14', 'Galaxy S23') | |
| desiredBrowser | No | Browser name for desktop: 'chrome', 'firefox', 'safari', 'edge', 'ie' | |
| desiredOSVersion | Yes | OS version (e.g., '11' for Windows 11, '16.0' for iOS 16) | |
| desiredBrowserVersion | No | Browser version or 'latest' (default: latest) |