run_test
Executes a saved test on a new device or specified session, returning a run ID for get_run. Use it to verify app behavior on live cloud devices.
Instructions
Run a saved test. With session_id it runs on that session (the device you are driving). Without it, VibeView always starts a new device of the test app's platform, runs the test and stops the device (it does not use a session you hold from dev_start; pass session_id to run on a session you hold). Returns a run id for get_run.
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": {
"test": "<test>"
},
"name": "run_test"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| test | Yes | Test id (from create_test or the Tests page). | |
| ai_use | No | smart (default): replays recorded and learned paths, and uses AI only where the screen changed or a step has no path yet; no_ai: replays only, no AI and no usage credit (a step with no path is not checked); ai_only: the AI does every step. | |
| session_id | No | Run on this session instead of a new device. | |
| device_model | No | Device model for a new device (from list_device_models); omitted: any free one. A model of another platform (same form factor) runs the test's app for that platform: the app linked in its app family, else the app with the same bundle id / package. The reply names the platform and app the run went to. | |
| start_from_current_screen | No | With session_id: no reset before the test. |