API Reference
Dashboard
  1. API Reference
  2. Box API
  3. Rotation

Get new public IPs for every proxy on the box

Use this to rotate every slot that has a SIM in one call. Rotations run in parallel; the answer is status: true once all requests are sent and does not report per-slot results. Without the IP rotation feature in the license the answer is msg: need upgrade (with a space) and no status field.

  • Destructive · confirm first
  • Basic auth when API auth is on
  • Public API · since v20.8.0
  • Hub: needs owner approval
  • rotateIpAllLegacy
GET/reset_all

Authentication

Always needs a trusted caller (loopback, LAN unless "force auth for local" is on, whitelisted IP, allowed Tailscale) or valid dashboard Basic credentials, which are checked only when dashboard authentication is enabled.

Responses

Requests sent, or the license lacks IP rotation.

statusbooleanoptional
msgstringoptional
Verified against XProxy v21.3.2 on Nov 17, 2026