Skip to main content
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, use PUT /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.
Example Response:

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.