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

Set a slot's users and whitelist, then rotate its IP

Intended for reseller panels to rotate a slot. It first replaces the slot's proxy users and IP whitelist with the given values (omitted means empty), then asks for a rotation. In the code at the verified commit the rotation call is missing a required argument, so after the users and whitelist are replaced the box answers HTTP 500 and no rotation happens; use /api/v1/rotate_ip/position/{position} to rotate.

  • Action · reversible
  • Basic auth when API auth is on
  • Public API · since v20.8.0
  • Hub: needs owner approval
  • minGetNewProxy
GET/api/min/get-new-proxy

Query parameters

positionintegerrequired

Slot number.

Example 1
authentication_usersstringoptional

Proxy users for the slot as user:password pairs in the box's user-list format. Omitted means none.

Example user1:YOUR_PROXY_PASSWORD
authorization_ipsstringoptional

Client IPs allowed without a password, comma separated. Omitted means none.

Example 198.51.100.7

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. "Basic auth for all API" does not change this route.

Responses

Rotation result (as designed; see the description).

codeintegeroptional
One of 0, 1
statusstringoptional
Verified against XProxy v21.3.2 on Nov 17, 2026