IP rotation

Rotation links

A rotation link is a tokenized endpoint for scripts and tools that can send an explicit HTTP POST. Opening it as a normal browser URL sends GET and does not rotate the device.

Create a link

Create the link with an authenticated POST. Treat the returned token as a secret because callers do not send a separate authorization header.

curl -X POST \
  https://mobileproxy.app/api/v1/subscriptions/SUBSCRIPTION_ID/rotation-links \
  -H "Authorization: Bearer mpx_live_…"

# → { "token": "rk_9f2c81d4e7",
#     "url": "https://mobileproxy.app/rotate/rk_9f2c81d4e7" }

Use it

Trigger the link with HTTP POST. Do not paste it into an address bar or configure it in a tool that only fetches rotation URLs with GET.

curl -X POST https://mobileproxy.app/rotate/rk_9f2c81d4e7

# → { "status": "rotating", "device": "…" }

Treat the token like a password

Anyone with the link can rotate that device's IP. Share it only with tools you trust, and revoke it the moment you don't need it.

Revoke it

curl -X DELETE https://mobileproxy.app/api/v1/rotation-links/rk_9f2c81d4e7 \
     -H "Authorization: Bearer mpx_live_…"

The same best-effort caveat applies as for any rotation — see How rotation works. A link triggers a re-dial; whether the carrier issues a new exit_ip is the carrier's call.