Resumes execution of a previously paused task. The task will continue from where it was paused. You can't resume a stopped task.

Resume Task

Location

Message

Error Type

ValidationError

HTTPBearer

HTTPValidationError

Browser Use

Welcome to Browser Use - We enable AI to control your browser

Introduction

Start using Browser Use with this quickstart guide

Quickstart

Guide to using different LangChain chat models with Browser Use

Supported Models

Agent Settings

Launch or connect to an existing browser and configure it to your needs.

Browser Settings

Connect to a remote browser or launch a new local browser.

Connect to your Browser

The default is text. But you can define a structured output format to make post-processing easier.

Output Format

Customize the system prompt to control agent behavior and capabilities

System Prompt

Handle sensitive information securely and avoid sending PII & passwords to the LLM.

Sensitive Data

Extend default agent and write custom action functions to do certain tasks

Custom Functions

Customize agent behavior with lifecycle hooks

Lifecycle Hooks

Contribution Guide

Set up Browser Use development environment locally

Local Setup

Understanding Browser Use's telemetry and privacy settings

Telemetry

Trace Browser Use's agent execution steps and browser sessions

Observability

Test the Browser Use agent on standardized benchmarks

Evaluations

Future plans and upcoming features for Browser Use

Roadmap

Learn how to get started with the Browser Use Cloud API

Learn how to implement the Browser Use API in Python

Implementing the API

Learn how to integrate webhooks with Browser Use Cloud API

Webhooks

Requires an active subscription. Returns the task ID that can be used to track progress.

Run Task

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.

Stop Task

Pauses execution of a running task. The task can be resumed later using the `/resume-task` endpoint. Useful for manual intervention or inspection.

Pause Task

Returns comprehensive information about a task, including its current status, steps completed, output (if finished), and other metadata.

Get Task

Returns just the current status of a task (created, running, finished, stopped, or paused).
More lightweight than the full task details endpoint.

Get Task Status

Returns links to any recordings or media generated during task execution,
such as browser session recordings. Only available for completed tasks.

Get Task Media

Returns any screenshot urls generated during task execution.

Get Task Screenshots

Returns a gif url generated from the screenshots of the task execution.
Only available for completed tasks that have screenshots.

Get Task Gif

Returns a presigned url for downloading a file from the task output files.

Get Task Output File

Returns a paginated list of all tasks belonging to the user, ordered by creation date.
Each task includes basic information like status and creation time. For detailed task info, use the
get task endpoint.

List Tasks

Returns a presigned url for uploading a file to the user's files bucket.
After uploading a file, the user can use the `included_file_names` field
in the `RunTaskRequest` to include the files in the task.

Upload File Presigned Url

Create a scheduled task to run at regular intervals or based on a cron expression.
Requires an active subscription. Returns the scheduled task ID.

Create Scheduled Task

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.

List Scheduled Tasks

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

Get Scheduled Task

Update a scheduled task with partial updates.

Update Scheduled Task

Deletes a scheduled task. This will prevent any future runs of this task.
Any currently running instances of this task will be allowed to complete.

Delete Scheduled Task

Deletes the browser profile for the user.

Delete Browser Profile For User

Returns the user's current API credit balance, which includes both monthly subscription
credits and any additional purchased credits. Required for monitoring usage and ensuring sufficient
credits for task execution.

Check Balance

Returns a boolean value indicating if the API key is valid and the user is authenticated.

Cloud API

API v1.0

Resume Task

Authorizations

Query Parameters

Response