API Reference
Dashboard
  1. API Reference
  2. Box API
  3. Token links

Get a new public IP for a proxy with its per-port token link

Use this to let an end user rotate one proxy without the dashboard login. Works only while per-port authentication is on. Refuses with HTTP 401 reset_too_much when the last rotation was less than the minimum interval (5 seconds by default) ago; otherwise behaves like /reset.

  • Action · reversible
  • Port token in the URL
  • Public API · since v20.8.0
  • Hub: blocked by the Hub
  • rotateIpWithPortToken
GET/{token}/reset

Path parameters

tokenstringrequiredsecret

Per-port token of the proxy, shown in the panel when per-port authentication is on. Treat it like a password: anyone with the link can use it.

Query parameters

proxystringrequired

Proxy address as HOST:PORT, for example 192.0.2.10:4001. Only the port selects the slot.

Example 192.0.2.10:4001

Authentication

Authenticated only by the token in the path; the dashboard login and "Basic auth for all API" do not apply. Refusals answer HTTP 401 with a message.

Responses

Rotation accepted or refused (same codes as /reset).

statusbooleanrequired

True when the box accepted the request.

msgstringrequired

Outcome code or message (see the operation's error table).

Errors returned in msg

msgMeaningWhat to do
Not support!Per-port authentication is off on this box.Turn on per-port authentication in the proxy settings.
Unauthorized!The token does not match this port.Copy the link again from the panel.
Wrong port!No modem uses the port in proxy.Check the proxy value.
reset_too_muchThe last rotation was less than the minimum interval ago.Wait a few seconds and retry.
Verified against XProxy v21.3.2 on Nov 17, 2026