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
{
"type": "open_url",
"url": "https://example.com"
}Payload fields
typestringrequiredDiscriminator that selects the action or content shape.
"open_url"urlstringrequiredAbsolute URL or installed app scheme. javascript:, data:, file: and control characters are rejected.
"https://example.com"Unknown fields are rejected.
View JSON Schema
{
"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.
