---
title: "Attach a CDP browser"
method: POST
path: "/browsers/connect"
---

# Attach a CDP browser

`POST /browsers/connect`

## Request

- Base URL: `https://oyabrowser.com`
- URL: `https://oyabrowser.com/browsers/connect`
- Auth: HTTP bearer

Attaches a browser the server dials out to, with no persona: any Chrome with --remote-debugging-port, or a vendor session. A second attach on an endpoint another browser already holds answers 409 endpoint_in_use; the body names the holder's id when it is yours.

## Request body

- object
  - `wsUrl` string: The ws://, wss:// or http:// address of the debugging port.
  - `provider` string: cdp (default) or a vendor name.
  - `name` string: A display name for the browser.

## Response `201`

Attached.

- object
  - `id` string
  - `provider` string
  - `clientType` string

## Other responses

- `400`: A field was malformed; the body names it.
- `409`: Endpoint already held by a running browser (endpoint_in_use).
- `429`: The key is at its browser quota.
- `502`: Could not attach to the CDP browser.

---

[API](https://skmtc.dev/oyabrowser/apis/oya-browser-api.md) · [All operations](https://skmtc.dev/oyabrowser/apis/oya-browser-api/llms.txt) · [OpenAPI document](https://skmtc.dev/oyabrowser/apis/oya-browser-api/revisions/748c4b34f8e4?raw)