API Reference
Dashboard
  1. API Reference
  2. Box API
  3. Modem reboot

Reboot the modem behind one proxy

Use this when a proxy stays offline or slow and a rotation does not help. Reboots the modem of the slot behind the port. When a router-type modem does not answer, the box resets its USB port instead. The proxy is offline until the modem is back (usually 30-120 seconds).

  • Action · reversible
  • Basic auth when API auth is on
  • Public API · since v20.8.0
  • Hub: needs owner approval
  • rebootDongleForProxy
GET/api/v1/reboot/proxy/{proxy}

Path parameters

proxystringrequired

Proxy address as HOST:PORT. Only the port is used to find the slot; the host part is ignored (any non-empty text without a colon works). Use the HTTP or SOCKS5 port shown in the panel or in /api/v1/info_list.

Example 192.0.2.10:4001

Authentication

Open by default: with "Basic auth for all API" (api_auth_check) off, anyone who can reach the box can call it. When it is on, the caller must be trusted (loopback, LAN unless "force auth for local" is on, whitelisted IP, allowed Tailscale) or send dashboard Basic credentials, which are checked only when dashboard authentication (dashboard_disable_auth off) is enabled.

Responses

Reboot result.

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
modem_not_foundNo slot matches the port or position.Use a port or position from /api/v1/info_list.
Reboot failed: modem did not answerThe modem ignored the reboot and the USB reset was not possible.Check the modem and its USB connection on site.
Modem disconnected!The modem type cannot be rebooted by the box.Check the modem in the panel.
invalid_format_proxyThe proxy value is not HOST:PORT.Send it as HOST:PORT, for example 192.0.2.10:4001.
Verified against XProxy v21.3.2 on Nov 17, 2026