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

Reboot the modem in one slot

Use this when a slot stays offline and a rotation does not help. Reboots the modem by slot number; 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
  • rebootDongleForPosition
GET/api/v1/reboot/position/{position}

Path parameters

positionintegerrequired

Slot number (position) on the box, starting at 1. A value that is not an integer makes the box answer HTTP 500.

Example 1

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