Skip to main content
Pauses a device: new tasks are rejected with the device_paused reason code until you call phone_device_resume. Use it as a safety switch when you want to guarantee nothing new starts on a phone.

​
Parameters

​
string
The device to pause. Omit to use your default device.

​
Behavior

  • New tasks are blocked - phone_run_task calls targeting the device fail with device_paused.
  • In-flight tasks keep running. Pausing a device does not stop work that is already executing. To stop current work too, use phone_task_cancel or phone_session_end.
Device pause is different from task pause. phone_task_pause suspends one running task so it can be resumed later; device pause gates the whole device against new work.