FleetDeckDocs

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

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

Payload fields

typestringrequired

Discriminator that selects the action or content shape.

Allowed:"launch_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": [
        "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.