> ## Documentation Index
> Fetch the complete documentation index at: https://smithers.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# createBrowserSession

> Gateway browser service RPC.

`createBrowserSession` controls a gateway-local ephemeral Chromium session.

* Method: `createBrowserSession`
* Scope: `run:write`
* Transports: HTTP RPC, WebSocket RPC

Request: `{ source: { kind: "url", url } | { kind: "dev-server", port, path? }, viewport? }`.
Response: a `BrowserSnapshot`: opaque `sessionId`, status, revision, page summary, viewport, control owner.

Errors are versioned as `v1` and include `InvalidRequest`, `Unauthorized`, `Forbidden`, `REVISION_CONFLICT`, `SSRF_BLOCKED`, `QUOTA_EXCEEDED`, and `Internal`.