PUT
/
api
/
v1
/
pause-task
import requests

url = "https://api.browser-use.com/api/v1/pause-task"
params = {"task_id": "task_1234567890abcdef"}
headers = {"Authorization": "Bearer <token>"}

response = requests.request("PUT", url, headers=headers, params=params)

print(response.text)

{}

Pauses execution of a running task. The task can be resumed later using the /resume-task endpoint. Useful for manual intervention or inspection.

​
Parameters

​
task_id
string
required

ID of the task to pause

​
Response

The endpoint returns an empty response body with a 200 status code on success.

import requests

url = "https://api.browser-use.com/api/v1/pause-task"
params = {"task_id": "task_1234567890abcdef"}
headers = {"Authorization": "Bearer <token>"}

response = requests.request("PUT", url, headers=headers, params=params)

print(response.text)

{}

​
Usage Notes

  • Paused tasks can be resumed using the /resume-task endpoint
  • The task status will change to “paused”
  • Browser automation will be temporarily halted
  • Useful for manual intervention or inspection during task execution

Pausing is useful when you need to temporarily halt execution to inspect the current state or make manual adjustments before resuming.