Skip to main content

​
Rotate session

Only dynamic sessions support rotation. Call POST /sessions/{session_id}/rotate to get a new exit IP. Sending a reason helps telemetry and risk scoring.

​
Request

curl -X POST "https://api.nexalayer.net/v1/sessions/sess_a1b2c3d4-e5f6-7890/rotate" \
  -H "X-API-Key: <api_key>" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "http_403" }'

​
Reason values

ValueDescription
http_403Target returned 403
http_429Target rate-limited
captchaCaptcha encountered
timeoutConnection timeout
blockIP blocked
scheduledTimed rotation
manualManual (default)
Use the returned new_proxy.full_url for subsequent requests. Session ID is unchanged. Next: Telemetry (report events to get rotation recommendations).