FleetDeckDocs

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

json
{
  "type": "kill_app",
  "bundleId": "com.example.app"
}

Payload fields

typestringrequired

Discriminator that selects the action or content shape.

Allowed:"kill_app"
bundleIdstringrequired

Installed iOS bundle ID or Android package name.

min 1 charactersmax 255 characters
Example: "com.example.app"
Validation pattern^[A-Za-z0-9][A-Za-z0-9._-]*$

Unknown fields are rejected.

View JSON Schema
json
{
  "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.