curl --request GET \
--url https://api.platform.soax.com/v1/proxy/packages/{package_id}/stateful-sessions/{session_id}/rotateimport requests
url = "https://api.platform.soax.com/v1/proxy/packages/{package_id}/stateful-sessions/{session_id}/rotate"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.platform.soax.com/v1/proxy/packages/{package_id}/stateful-sessions/{session_id}/rotate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.platform.soax.com/v1/proxy/packages/{package_id}/stateful-sessions/{session_id}/rotate",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.platform.soax.com/v1/proxy/packages/{package_id}/stateful-sessions/{session_id}/rotate"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.platform.soax.com/v1/proxy/packages/{package_id}/stateful-sessions/{session_id}/rotate")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.platform.soax.com/v1/proxy/packages/{package_id}/stateful-sessions/{session_id}/rotate")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"id": "7c1e9a52-3b4d-4f6a-9e8b-2d5c0a1f6b3e",
"name": "checkout1",
"exit_ip": "198.51.100.17",
"network_type": "wifi",
"country": "us",
"region": "california",
"city": "los_angeles",
"isp": "charter_communications",
"asn": "20001",
"zip": null,
"bound_since": "2026-10-27T10:21:40Z"
}{
"detail": "Package is suspended and cannot provision stateful sessions."
}{
"detail": "<string>"
}{
"detail": "Session not found"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"detail": "Rotation is rate-limited to 1 per second per session."
}Rotate through the rotation link
Rotate the session to a new exit IP with a plain GET, for tools that cannot send an Authorization header, such as antidetect browsers’ “Change IP URL”. Use the session’s rotation_url as is. The token query parameter is the only credential and authorizes this one session only. The URL is a secret: anyone who opens it rotates the session, including link previewers and scanners, so share it only with the tool that uses it. Regenerate it with Regenerate rotation link if it leaks.
Shares the limit of one rotation per second per session. A wrong token, an unknown session, or a session of another package all answer 404. The response is not cached.
curl --request GET \
--url https://api.platform.soax.com/v1/proxy/packages/{package_id}/stateful-sessions/{session_id}/rotateimport requests
url = "https://api.platform.soax.com/v1/proxy/packages/{package_id}/stateful-sessions/{session_id}/rotate"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.platform.soax.com/v1/proxy/packages/{package_id}/stateful-sessions/{session_id}/rotate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.platform.soax.com/v1/proxy/packages/{package_id}/stateful-sessions/{session_id}/rotate",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.platform.soax.com/v1/proxy/packages/{package_id}/stateful-sessions/{session_id}/rotate"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.platform.soax.com/v1/proxy/packages/{package_id}/stateful-sessions/{session_id}/rotate")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.platform.soax.com/v1/proxy/packages/{package_id}/stateful-sessions/{session_id}/rotate")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"id": "7c1e9a52-3b4d-4f6a-9e8b-2d5c0a1f6b3e",
"name": "checkout1",
"exit_ip": "198.51.100.17",
"network_type": "wifi",
"country": "us",
"region": "california",
"city": "los_angeles",
"isp": "charter_communications",
"asn": "20001",
"zip": null,
"bound_since": "2026-10-27T10:21:40Z"
}{
"detail": "Package is suspended and cannot provision stateful sessions."
}{
"detail": "<string>"
}{
"detail": "Session not found"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}{
"detail": "Rotation is rate-limited to 1 per second per session."
}Path Parameters
The package's ID. To find it, open the package in Packages and expand the header, or call List packages.
^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$Response
Successful Response
The new binding of a session rotated through its rotation link. No connection string, ruleset or token.
Was this page helpful?