Action payload · devices:control
launch_app
Launch an installed iOS bundle ID or Android package. Identifier length 1..255, starts alphanumeric and then uses letters, digits, dot, underscore or hyphen. Verify the foreground app afterward; relay submission is not proof of launch.
Payload
{
"type": "launch_app",
"bundleId": "com.example.app"
}Payload fields
typestringrequiredDiscriminator that selects the action or content shape.
"launch_app"bundleIdstringrequiredInstalled iOS bundle ID or Android package name.
"com.example.app"Validation pattern
^[A-Za-z0-9][A-Za-z0-9._-]*$Unknown fields are rejected.
View JSON Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"launch_app"
],
"description": "Discriminator that selects the action or content shape."
},
"bundleId": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$",
"description": "Installed iOS bundle ID or Android package name."
}
},
"required": [
"type",
"bundleId"
],
"additionalProperties": false,
"description": "Launch an installed iOS bundle ID or Android package. Identifier length 1..255, starts alphanumeric and then uses letters, digits, dot, underscore or hyphen. Verify the foreground app afterward; relay submission is not proof of launch.",
"example": {
"type": "launch_app",
"bundleId": "com.example.app"
}
}REST wraps this payload inside {requestId, command}. The matching MCP tool takes sessionId and requestId plus these fields, without the type discriminator.
Contract
Submit this as command to POST /sessions/{sessionId}/actions, pass it as the CLI action JSON, or use the matching MCP convenience tool. Command objects are strict and reject unknown fields.
Execution
Launch an installed iOS bundle ID or Android package. Identifier length 1..255, starts alphanumeric and then uses letters, digits, dot, underscore or hyphen. Verify the foreground app afterward; relay submission is not proof of launch.
Action status and driver result remain separate. A completed result can still require a fresh screenshot or hierarchy check to prove the intended visible effect.
