---
title: "Start a browser session that runs on the user's own machine"
method: POST
path: "/api/v1/browse-local"
tags: ["Runs"]
---

# Start a browser session that runs on the user's own machine

`POST /api/v1/browse-local`

## Request

- Base URL: `https://unbrowse.ai`
- URL: `https://unbrowse.ai/api/v1/browse-local`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://unbrowse.ai/authorize`, token URL `https://unbrowse.ai/oauth/token`, scopes: `unbrowse`)
  - HTTP bearer

The agent drives the browser (open/snapshot/act/finish), but it runs locally through the CLI's `unbrowse browse --local` — the user's own browser, session and IP. What it learns is kept private to the workspace and is never shared to the public registry (the user's machine is not a trusted recorder). This is a CLI capability; a hosted MCP client cannot reach a local browser.

## Response `201`

The session; connect the CLI to drive it

- object
  - `sessionId` string
  - `connect` string
  - `ops` string

## Other responses

- `400`: An error
- `401`: Missing or invalid credentials. The WWW-Authenticate header names the protected-resource metadata.
- `402`: An error
- `404`: An error
- `429`: An error

---

[API](https://skmtc.dev/unbrowse/apis/unbrowse-api.md) · [All operations](https://skmtc.dev/unbrowse/apis/unbrowse-api/llms.txt) · [OpenAPI document](https://skmtc.dev/unbrowse/apis/unbrowse-api/revisions/f49034a1fbff?raw)