> ## 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_task_pause

> Pause a running task so it can be resumed later.

Requests a pause on a running task. The immediate `pausing` response confirms the request was **sent** - not that the task is paused yet. Monitor until the task reports `paused` or `completed`.

## Parameters

<ParamField body="session_id" type="string" required>
  The active session that owns the task.
</ParamField>

<ParamField body="task_id" type="string" required>
  The task to pause.
</ParamField>

## Behavior

1. The call returns `pausing` immediately.
2. Call [`phone_task_monitor`](/api-reference/tools/phone-task-monitor) until
   the task reports `paused` or `completed`.
3. Resume only a `paused` task, with
   [`phone_task_resume`](/api-reference/tools/phone-task-resume).

If the task completed before the pause took effect, handle its `terminal` through the [terminal outcomes table](/guides/concepts/task-lifecycle#terminal-outcomes) instead - there is nothing to resume.

* A `paused` task keeps its `task_id`; pausing never creates a replacement
  task.
* Time spent paused does not count against the task's execution timeout
  (`per_call_timeout_s`).

<Note>
  Task pause suspends one task. To block a whole device from accepting new
  work, use [`phone_device_pause`](/api-reference/tools/phone-device-pause).
</Note>

## Related

* [`phone_task_resume`](/api-reference/tools/phone-task-resume) - continue the task
* [`phone_task_cancel`](/api-reference/tools/phone-task-cancel) - stop it permanently