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

Reboot the modem behind one proxy (legacy query-string form)

Use this only for existing integrations; new code should use /api/v1/reboot/proxy/{proxy}. Needs the IP rotation feature in the license (need_upgrade otherwise). A non-answering router-type modem gets a USB reset instead.

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

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

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
need_upgradeThe license does not include IP rotation.Upgrade the license.
invalid_format_proxyproxy is missing or not HOST:PORT.Send proxy=HOST:PORT.
Not found!No slot uses this port.Use a port from /api/v1/info_list.
Reboot failed: modem did not answerThe modem ignored the reboot and no USB reset was possible.Check the modem on site.
Modem disconnected!The slot has no modem the box can reboot.Check the modem in the panel.
Verified against XProxy v21.3.2 on Nov 17, 2026