> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agi.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# phone_device_pause

> Block new tasks on a device until it is resumed.

Pauses a device: new tasks are rejected with the `device_paused` reason code until you call [`phone_device_resume`](/api-reference/tools/phone-device-resume). Use it as a safety switch when you want to guarantee nothing new starts on a phone.

## Parameters

<ParamField body="device_id" type="string">
  The device to pause. Omit to use your default device.
</ParamField>

## Behavior

* **New tasks are blocked** - [`phone_run_task`](/api-reference/tools/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`](/api-reference/tools/phone-task-cancel) or
  [`phone_session_end`](/api-reference/tools/phone-session-end).

<Note>
  Device pause is different from task pause.
  [`phone_task_pause`](/api-reference/tools/phone-task-pause) suspends one
  running task so it can be resumed later; device pause gates the whole device
  against new work.
</Note>

## Related

* [`phone_device_resume`](/api-reference/tools/phone-device-resume) - lift the pause
* [`phone_device_status`](/api-reference/tools/phone-device-status) - check whether a device is paused
* [`phone_task_cancel`](/api-reference/tools/phone-task-cancel) - stop an in-flight task