Rotate Session Proxy
Session Proxy
Rotate Session Proxy
Rotate to a new exit IP while keeping the current provider and location.
POST
Rotate Session Proxy
Overview
Requests a fresh exit IP from the same provider and location currently attached to the session. Useful when the current IP has been rate-limited or blocked but you still want the same geography. To change provider or location, usePUT /browser/sessions/{id}/proxy. To go direct, use DELETE /browser/sessions/{id}/proxy.
Path Parameters
string
required
Browser session ID (UUID).
Example Request
Response
Success Response (200)
boolean
True when rotation was requested successfully.
string
New exit IP, when reported by the provider.
Error Responses
Notes
- Rotation is best-effort — some providers return a new IP synchronously, others rotate on the next outbound request.
- Rotation does not clear browser cookies, local storage, or open connections. Pair with a fresh session if you need a fully clean slate.