GET /connect
Creates a browser on the cloud platform and returns the direct CDP WebSocket URL. After this call, your CDP traffic goes directly to the browser — the gateway is not in the data path.
URL: GET /connect
Auth: x-api-key header and/or token query parameter
Query parameters
Section titled “Query parameters”All parameters from the local /connect endpoint are supported, plus:
| Parameter | Description |
|---|---|
token | API key (alternative to x-api-key header) |
backend | Engine identifier |
maxLifetime | Session TTL in seconds |
vnc | true to start per-browser noVNC session |
protection.* | Per-feature fingerprint overrides (e.g. protection.canvas=noise) |
Response
Section titled “Response”Body: Plain text CDP WebSocket URL
Headers:
| Header | Description |
|---|---|
x-session-id | Unique session identifier (use for reconnection) |
x-vnc-url | noVNC URL (when vnc=true) |
Example
Section titled “Example”curl "https://cloud.rayobrowse.com/connect?token=your-key&os=windows&headless=true" \ -H "x-api-key: your-key"Response body:
wss://backend-host:port/cdp/session-id