FleetDeckDocs

Action payload · devices:control

open_url

Open an absolute scheme URL, maximum 4,096 characters. javascript:, data:, file: and control characters are rejected. Custom app schemes need an installed handler. Stock iPhone relay requires a native bridge for this command.

Payload

json
{
  "type": "open_url",
  "url": "https://example.com"
}

Payload fields

typestringrequired

Discriminator that selects the action or content shape.

Allowed:"open_url"
urlstringrequired

Absolute URL or installed app scheme. javascript:, data:, file: and control characters are rejected.

min 1 charactersmax 4,096 characters
Example: "https://example.com"

Unknown fields are rejected.

View JSON Schema
json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "open_url"
      ],
      "description": "Discriminator that selects the action or content shape."
    },
    "url": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Absolute URL or installed app scheme. javascript:, data:, file: and control characters are rejected."
    }
  },
  "required": [
    "type",
    "url"
  ],
  "additionalProperties": false,
  "description": "Open an absolute scheme URL, maximum 4,096 characters. javascript:, data:, file: and control characters are rejected. Custom app schemes need an installed handler. Stock iPhone relay requires a native bridge for this command.",
  "example": {
    "type": "open_url",
    "url": "https://example.com"
  }
}

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

Open an absolute scheme URL, maximum 4,096 characters. javascript:, data:, file: and control characters are rejected. Custom app schemes need an installed handler. Stock iPhone relay requires a native bridge for this command.

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.