API Reference
Dashboard
  1. API Reference
  2. Box API
  3. Modems

Lock a Huawei Hilink modem to some bands or a network mode

Use this to force a modem onto a band or 4G only. Works only for HW-Hilink modems. Values are hexadecimal masks as returned by GET /band_list; a missing field resets to all (NetworkMode 00 auto, NetworkBand 3FFFFFFF, LTEBand 7FFFFFFFFFFFFFFF). The modem re-registers on the network.

  • Destructive · confirm first
  • Basic auth
  • Panel API · since v20.8.0
  • Hub: needs owner approval
  • setBand
POST/set_band

Request body application/json · required

positionintegerrequired
NetworkModestringoptional

Network mode code, for example 00 auto, 03 4G only, 02 3G only.

NetworkBandstringoptional

2G/3G band mask (hex).

LTEBandstringoptional

LTE band mask (hex).

Authentication

Needs dashboard Basic credentials when dashboard authentication is enabled; trusted callers (loopback, LAN unless "force auth for local" is on, whitelisted IP, allowed Tailscale) pass without them.

Responses

Modem answer or a refusal.

statusbooleanrequired

False when the body was missing, the slot is empty, or the modem call raised an error.

dataobject | string | nullrequired

Modem answer.

Errors returned in msg

msgMeaningWhat to do
Dongle do not support!(in data) The modem is not a Huawei Hilink.Use the panel tools of that modem type.
(data empty, status false) No JSON body, empty slot, or the modem did not answer.Send position in a JSON body and check the modem is online.
Verified against XProxy v21.3.2 on Nov 17, 2026