POST
/
api
/
v1
/
run-task
curl --request POST \
  --url https://api.browser-use.com/api/v1/run-task \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "task": "<string>",
  "save_browser_data": true,
  "structured_output_json": "<string>"
}'
{
  "id": "<string>"
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json

task: What should the agent do. You can try it out at https://cloud.browser-use.com/

save_browser_data: If set to True, the browser cookies and other data will be saved. Cookies are safely encrypted before storing in the database.

structured_output_json: If set, the agent will use this JSON schema as the output model (see example here: https://docs.browser-use.com/cloud/implementation#structured-output-example).

​
task
string
required
​
save_browser_data
boolean | null
default:false
​
structured_output_json
string | null

Response

200
application/json
Successful Response
​
id
string
required

Was this page helpful?