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

Get new public IPs for several proxies at once

Use this to rotate a list of ports in one call: proxy=HOST:4001,4002,4003. Every slot with a SIM whose HTTP, SOCKS5 or other proxy port is in the list is rotated in parallel. The answer is always status: true once the requests are sent; check each proxy's status for the outcome. A missing proxy answers HTTP 500.

  • Action · reversible
  • Basic auth when API auth is on
  • Public API · since v20.8.0
  • Hub: needs owner approval
  • rotateIpGroup
GET/reset_group

Query parameters

proxystringrequired

HOST followed by a colon and a comma-separated list of ports.

Example 192.0.2.10:4001,4002,4003

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.

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