- API Reference
- Box API
- 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).
/api/v1/reboot/proxy/{proxy}Path parameters
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.
192.0.2.10:4001Authentication
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.
True when the box accepted the request.
Outcome code or message (see the operation's error table).
The caller is not trusted (not loopback, LAN, whitelisted or allowed Tailscale) and sent no valid Basic credentials. The body depends on whether "Basic auth for all API" is on. Routes that also use the panel login can answer a plain-text 401 "Unauthorized Access" instead.
Errors returned in msg
| msg | Meaning | What to do |
|---|---|---|
modem_not_found | No slot matches the port or position. | Use a port or position from /api/v1/info_list. |
Reboot failed: modem did not answer | The 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_proxy | The proxy value is not HOST:PORT. | Send it as HOST:PORT, for example 192.0.2.10:4001. |