#Rotation links

Every proxy has a secret rotation link that changes its IP without an API token. It is the rotation_url field of the proxy object and is shown on the proxy's page in the panel:

https://proxykite.com/r/<rotation_token>

Anyone who has the link can rotate that one proxy, so treat it like a password.

#Rotating

Send a POST, or a GET with ?confirm=1 for tools that can only send GET. The call waits for the rotation to finish (up to about 60 seconds) — use a client timeout of at least 90 s.

curl -X POST 'https://proxykite.com/r/<rotation_token>'
# GET-only tools:
curl 'https://proxykite.com/r/<rotation_token>?confirm=1'

import requests

r = requests.post("https://proxykite.com/r/<rotation_token>", timeout=90)
print(r.status_code, r.json())

const res = await fetch('https://proxykite.com/r/<rotation_token>', {
  method: 'POST',
  signal: AbortSignal.timeout(90_000),
});
console.log(res.status, await res.json());

<?php
$ch = curl_init('https://proxykite.com/r/<rotation_token>');
curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 90]);
$body = curl_exec($ch);
var_dump(curl_getinfo($ch, CURLINFO_HTTP_CODE), json_decode($body, true));

#A plain GET does not rotate

Chat apps, mail scanners and link previewers open pasted links. To stop them from rotating your IP, a plain GET (without confirm=1) does nothing:

• a browser gets a small page with a Rotate now button (which sends a POST);
• any other client gets 400 {"ok": false, "error": "confirm_required", "message": "…"}.

confirm=true and confirm=yes work too.

#Answers

Every error body is {"ok": false, "error": "<code>", "message": "…"}.

#Link or API?