Run Task | Browser Use Cloud Docs

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

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

This endpoint expects an object.

taskstringRequired>=1 character<=20000 characters

secretsmap from strings to strings or nullOptional

allowed_domainslist of strings or nullOptional

save_browser_databoolean or nullOptionalDefaults to false

structured_output_jsonstring or nullOptional

llm_modelenum or nullOptional

highlight_elementsboolean or nullOptionalDefaults to true

included_file_nameslist of strings or nullOptional

max_agent_stepsinteger or nullOptional>=1<=200Defaults to 75

enable_public_shareboolean or nullOptionalDefaults to false

browser_profile_idstring or nullOptionalformat: "uuid"

use_adblockboolean or nullOptional

use_proxyboolean or nullOptional

proxy_country_codeenum or nullOptional

browser_viewport_widthinteger or nullOptional>=100<=3840Defaults to 1280

browser_viewport_heightinteger or nullOptional>=100<=2160Defaults to 960

metadatamap from strings to strings or nullOptional

use_stealthboolean or nullOptional

Successful Response

idstringformat: "uuid"

1	curl -X POST https://api.browser-use.com/api/v1/run-task \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"task": "string"
6	}'