PUT
/
api
/
v1
/
stop-task
import requests

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

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

print(response.text)

{}

Stops a running browser automation task immediately. The task cannot be resumed after being stopped. Use /pause-task endpoint instead if you want to temporarily halt execution.

​
Parameters

​
task_id
string
required

ID of the task to stop

​
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/stop-task"
params = {"task_id": "task_1234567890abcdef"}
headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

{}

​
Usage Notes

  • Once a task is stopped, it cannot be resumed
  • The task status will change to “stopped”
  • Any ongoing browser automation will be immediately terminated
  • Use the pause endpoint if you need to temporarily halt execution with the ability to resume later

Stopping a task is irreversible. If you need to pause execution temporarily, use the /pause-task endpoint instead.