Skip to main content
POST
/
browser
/
sessions
/
{id}
/
proxy
/
rotate
Rotate Session Proxy
curl --request POST \
  --url https://api.example.com/browser/sessions/{id}/proxy/rotate
{
  "success": true,
  "newIp": "<string>"
}

​
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

​
id
string
required
Browser session ID (UUID).

​
Example Request

curl -X POST "https://api.scrapengine.io/api/v1/browser/sessions/baa3f390-fa6e-4a24-b84a-a575a5f3a9c7/proxy/rotate" \
  -H "Authorization: Bearer $SCRAPENGINE_API_KEY"

​
Response

​
Success Response (200)

​
success
boolean
True when rotation was requested successfully.
​
newIp
string
New exit IP, when reported by the provider.
Example Response: 
{
  "success": true,
  "newIp": "203.0.113.42"
}

​
Error Responses

StatusDescription
401Unauthorized — invalid or missing API key.
404Session not found or not owned by the caller.
409Session is not running with a managed proxy — nothing to rotate.
503The proxy provider is temporarily unreachable.

​
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.