Proxies
How a browser’s exit is chosen at create is in the Proxies guide. These routes read and change it while the browser runs, without restarting Chrome.
The exit
Section titled “The exit”{ "mode": "managed", "country": "de", "sticky": true, "exitIp": "84.150.12.7" }| Field | |
|---|---|
mode |
managed (residential), direct (the machine’s own address) or custom (yours) |
country |
The managed exit’s country, else null |
sticky |
BrowserReal’s own: whether a managed exit keeps one address. null unless managed |
exitIp |
The address sites see, measured now. null for a custom proxy |
Get the exit
Section titled “Get the exit”GET /browsers/{id}/proxy → the exit. 409 when the browser is not running.
Change the exit
Section titled “Change the exit”PATCH /browsers/{id}/proxy → the exit
| Body | Does |
|---|---|
{ "mode": "managed", "country": "fr" } |
A residential address in another country |
{ "rotate": true } |
A new address, same country |
{ "target": "https://example.com" } |
A new address, same country (Browser Use’s form) |
{ "sticky": false } / { "sticky": true } |
BrowserReal’s own: rotating or sticky from now on |
{ "mode": "direct" } |
No proxy |
{ "mode": "custom", "customProxy": { … } } |
Your proxy |
Open connections are closed and the next ones go the new way. Tabs, cookies and storage stay.
Refused, as at Browser Use: 422 for a custom proxy with a country, target or rotate, and for sticky without a
managed exit; 409 to rotate a direct browser (ask for mode: "managed"), for a change on a custom proxy that does not
name its mode, for a change while another is under way, and for a stopped browser.