browser-use/docs/api-reference/stop-task.mdx

---
title: "Stop Task"
api: "PUT /api/v1/stop-task"
description: "Stops a running browser automation task immediately."
---

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

<ParamField query="task_id" type="string" required>
  ID of the task to stop
</ParamField>

## Response

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

<RequestExample>

```python python
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)
```

```bash cURL
curl --request PUT \
  --url 'https://api.browser-use.com/api/v1/stop-task?task_id=task_1234567890abcdef' \
  --header 'Authorization: Bearer <token>'
```

```javascript javascript 
const options = {method: 'PUT', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.browser-use.com/api/v1/stop-task?task_id=task_1234567890abcdef', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));
```
</RequestExample>

<ResponseExample>
    ```json 200
    {}
    ```

    ```json 422
    {
    "detail": [
        {
        "loc": [
            "query",
            "task_id"
        ],
        "msg": "field required",
        "type": "value_error.missing"
        }
    ]
    }
    ```
</ResponseExample>

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

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