GET
/
api
/
v1
/
scheduled-tasks
import requests

url = "https://api.browser-use.com/api/v1/scheduled-tasks"

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

response = requests.request("GET", url, headers=headers)

print(response.text)

{
  "tasks": [
    {
      "id": "scheduled_task_1234567890abcdef",
      "task": "Visit example.com and check if the site is up",
      "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": true,
      "created_at": "2023-01-01T00:00:00Z",
      "updated_at": "2023-01-01T00:00:00Z"
    }
  ],
  "total_pages": 1,
  "page": 1,
  "limit": 10,
  "total_count": 1
}

Returns a paginated list of all scheduled tasks belonging to the user, ordered by creation date. Each task includes basic information like schedule type, next run time, and status.

​
Query Parameters

​
page
integer
default:"1"

Page number (minimum: 1)

​
limit
integer
default:"10"

Number of items per page (minimum: 1)

​
Response

​
tasks
array

List of scheduled tasks

​
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

​
total_pages
integer

Total number of pages

​
page
integer

Current page number

​
limit
integer

Number of items per page

​
total_count
integer

Total number of scheduled tasks

import requests

url = "https://api.browser-use.com/api/v1/scheduled-tasks"

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

response = requests.request("GET", url, headers=headers)

print(response.text)

{
  "tasks": [
    {
      "id": "scheduled_task_1234567890abcdef",
      "task": "Visit example.com and check if the site is up",
      "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": true,
      "created_at": "2023-01-01T00:00:00Z",
      "updated_at": "2023-01-01T00:00:00Z"
    }
  ],
  "total_pages": 1,
  "page": 1,
  "limit": 10,
  "total_count": 1
}