Action payload · devices:control
kill_app
Terminate the identified app (Android force-stop). Same identifier rules as launch_app. Unsaved app work may be lost.
Payload
{
"type": "kill_app",
"bundleId": "com.example.app"
}Payload fields
typestringrequiredDiscriminator that selects the action or content shape.
"kill_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": [
"kill_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": "Terminate the identified app (Android force-stop). Same identifier rules as launch_app. Unsaved app work may be lost.",
"example": {
"type": "kill_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
Terminate the identified app (Android force-stop). Same identifier rules as launch_app. Unsaved app work may be lost.
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.
