PUT
/
api
/
v1
/
scheduled-task
/
{task_id}
import requests

url = "https://api.browser-use.com/api/v1/scheduled-task/{task_id}"

headers = {"Authorization": "Bearer <token>"}

payload = {
    "task": "Updated task description",
    "is_active": False
}

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

print(response.text)

{
  "id": "scheduled_task_1234567890abcdef",
  "task": "Updated task description",
  "save_browser_data": false,
  "structured_output_json": null,
  "llm_model": "gpt-4o",
  "use_adblock": true,
  "use_proxy": true,
  "highlight_elements": true,
  "schedule_type": "interval",
  "interval_minutes": 60,
  "cron_expression": null,
  "start_at": "2023-01-01T00:00:00Z",
  "next_run_at": "2023-01-01T01:00:00Z",
  "end_at": "2023-12-31T23:59:59Z",
  "is_active": false,
  "created_at": "2023-01-01T00:00:00Z",
  "updated_at": "2023-01-01T00:30:00Z"
}

Updates a scheduled task with partial updates. You can update any combination of the task configuration fields without affecting the others.

​
Path Parameters

​
task_id
string
required

ID of the scheduled task to update

​
Request Body

​
task
string

Instructions for what the agent should do

​
schedule_type
string

Type of schedule: “interval” or “cron”

​
interval_minutes
integer

Minutes between runs (required if schedule_type is “interval”)

​
cron_expression
string

Cron expression for scheduling (required if schedule_type is “cron”)

​
start_at
string

When to start the schedule (ISO 8601 format)

​
end_at
string

When to end the schedule (ISO 8601 format)

​
is_active
boolean

Whether the scheduled task is active

​
use_adblock
boolean

Whether to use an adblocker

​
use_proxy
boolean

Whether to use a proxy

​
highlight_elements
boolean

Whether to highlight elements on the page

​
llm_model
string

LLM model to use. Available options: gpt-4o, gpt-4o-mini, gpt-4.1, gpt-4.1-mini, o4-mini, o3, gemini-2.0-flash, gemini-2.0-flash-lite, gemini-2.5-flash-preview-04-17, gemini-2.5-flash, gemini-2.5-pro, claude-3-7-sonnet-20250219, claude-sonnet-4-20250514, llama-4-maverick-17b-128e-instruct

​
save_browser_data
boolean

Whether to save browser cookies and data between runs

​
structured_output_json
string

JSON schema for structured output

​
Response

Returns the updated scheduled task object with the same format as the Get Scheduled Task response.

​
id
string

The unique identifier for the scheduled task

​
task
string

Instructions for what the agent should do

​
save_browser_data
boolean

Whether to save browser cookies and data

​
structured_output_json
string

JSON schema for structured output

​
llm_model
string

LLM model to use

​
use_adblock
boolean

Whether to use an adblocker

​
use_proxy
boolean

Whether to use a proxy

​
highlight_elements
boolean

Whether to highlight elements on the page

​
schedule_type
string

Type of schedule: “interval” or “cron”

​
interval_minutes
integer

Minutes between runs

​
cron_expression
string

Cron expression for scheduling

​
start_at
string

When to start the schedule

​
next_run_at
string

When the next run is scheduled

​
end_at
string

When to end the schedule

​
is_active
boolean

Whether the scheduled task is active

​
created_at
string

When the scheduled task was created

​
updated_at
string

When the scheduled task was last updated

import requests

url = "https://api.browser-use.com/api/v1/scheduled-task/{task_id}"

headers = {"Authorization": "Bearer <token>"}

payload = {
    "task": "Updated task description",
    "is_active": False
}

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

print(response.text)

{
  "id": "scheduled_task_1234567890abcdef",
  "task": "Updated task description",
  "save_browser_data": false,
  "structured_output_json": null,
  "llm_model": "gpt-4o",
  "use_adblock": true,
  "use_proxy": true,
  "highlight_elements": true,
  "schedule_type": "interval",
  "interval_minutes": 60,
  "cron_expression": null,
  "start_at": "2023-01-01T00:00:00Z",
  "next_run_at": "2023-01-01T01:00:00Z",
  "end_at": "2023-12-31T23:59:59Z",
  "is_active": false,
  "created_at": "2023-01-01T00:00:00Z",
  "updated_at": "2023-01-01T00:30:00Z"
}