POST
/
action
/
start_browser_operator
curl --request POST \
  --url https://api-lr.agent.ai/v1/action/start_browser_operator \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Find the latest iPhone specifications on Apple'\''s website",
  "output_variable_name": "browser_operator_session"
}'
{
  "status": 200,
  "response": {
    "live_url": "https://app.hyperbrowser.ai/live?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXNzaW9uSWQiOiIxOTZiNDc3YS05NzQxLTQwNmUtYThlMS0xNGFiOTdhY2E5ZjIiLCJ0ZWFtSWQiOiIxOTdhZTAzNS0zYmJlLTQwNDMtODliYi0zZmRmOTE3OTBiOTciLCJpYXQiOjE3Mzk3ODAxMjcsImV4cCI6MTczOTgyMzMyN30.JOlCMyeSVqMdsXEMAIdMP3rwuz1XUMVss_8Sn4IFTy0&keepAlive=true",
    "session_id": "196b477a-9741-406e-a8e1-14ab97aca9f2",
    "task": "how were hubspot's Q4 2024 financial results? use bing.com",
    "uuid": "NTF5Cuvz2LZpctWfYZJSow",
    "ws_endpoint": "wss://connect.hyperbrowser.ai/?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXNzaW9uSWQiOiIxOTZiNDc3YS05NzQxLTQwNmUtYThlMS0xNGFiOTdhY2E5ZjIiLCJ0ZWFtSWQiOiIxOTdhZTAzNS0zYmJlLTQwNDMtODliYi0zZmRmOTE3OTBiOTciLCJpYXQiOjE3Mzk3ODAxMjcsImV4cCI6MTczOTgyMzMyN30.JOlCMyeSVqMdsXEMAIdMP3rwuz1XUMVss_8Sn4IFTy0"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer token from your account (https://agent.ai/user/settings#credits)

Body

application/json
​
prompt
string
required

Enter a question or statement to prompt the browser operator.

Example:

"Find the latest iPhone specifications on Apple's website"

​
output_variable_name
string
required

Provide a variable name to store the initialized browser operator session details.

Example:

"browser_operator_session"

Response

200
application/json
Browser operator started successfully
​
status
integer

HTTP status code of the action response

​
response
object

Response data from the action