Skip to main content
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

​
string
required
The active session that owns the task.
​
string
required
The task to pause.

​
Behavior

  1. The call returns pausing immediately.
  2. Call phone_task_monitor until the task reports paused or completed.
  3. Resume only a paused task, with phone_task_resume.
If the task completed before the pause took effect, handle its terminal through the terminal outcomes table 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).
Task pause suspends one task. To block a whole device from accepting new work, use phone_device_pause.