Skip to main content
POST
/
boxes
/
me
/
tg
/
auto
Tg Auto Start
const options = {method: 'POST', headers: {'X-Browser-Use-API-Key': '<api-key>'}};

fetch('https://api.browser-use.com/api/v3/boxes/me/tg/auto', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "session": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "state": "pending_browser",
    "live_url": "<string>",
    "bot_username": "<string>",
    "error_code": "bu_cloud_auth",
    "error_message": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.browser-use.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

X-Browser-Use-API-Key
string
header
required

Response

Successful Response

Returned by POST /me/tg/auto. The session is already running by the time this returns — frontend opens the iframe and starts polling.

session
TgAutoSessionView · object
required

Snapshot of a QR onboarding session. Returned by start, status, and cancel — same shape so the FE renders a single view component.