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

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

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

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

print(response.text)

{
  "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"
}

Returns detailed information about a specific scheduled task, including its schedule configuration and current status.

​
Path Parameters

​
task_id
string
required

ID of the scheduled task to retrieve

​
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>"}

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

print(response.text)

{
  "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"
}