Skip to main content
Sets the persistent default device. Tools that take an optional device_id - such as phone_run_task, phone_session_start, and phone_get_state - fall back to this device when the parameter is omitted.

​
Parameters

​
string
required
The device to make the default. Get IDs from list_devices.

​
Behavior

  • The default is persistent - it survives across sessions and connections until you change it again.
  • Changing the default does not reroute existing work: sessions and tasks stay bound to the device they started on. After a session starts, its session_id determines the target phone for phone_run_task and phone_session_end, and task controls use the device that owns the task_id.
With multiple devices, set the default once at the start of a workflow rather than passing device_id on every call - it keeps prompts simpler and avoids targeting the wrong phone mid-workflow.