---
title: "Select a browser page"
method: POST
path: "/v1/browser/select-page"
tags: ["Browser"]
---

# Select a browser page

`POST /v1/browser/select-page`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/browser/select-page`
- Auth: HTTP bearer

## Request body

- object
  - `id` string, required

## Response `200`

Updated browser status

- BrowserStatus
  - `connected` boolean, required
  - `recording` boolean, required
  - `pageUrl` string, nullable
  - `pageTitle` string, nullable
  - `channel` string, nullable
  - `networkLogging` boolean, required
  - `tracing` boolean, required
  - `intercepting` boolean, required
  - `workspace` BrowserWorkspaceRef: The browser workspace a caller's browser calls run in: one incarnation, never matched by a re-created one. Every browser event carries the ref of the workspace whose page raised it (null for a page no workspace holds).
    - `kind` 'browser', required
    - `handle` string, required
    - `generation` integer, required

## Other responses

- `400`: Invalid request

---

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