- API Reference
- Box API
- Modems
Change the MAC address of one or more modems
Use this to give modems new MAC addresses. Supported on XProxy XH20/XH22 modems; others are skipped silently. Mode 1 generates a random address based on mac.mac; mode 2 sets mac.mac as given. Each changed modem reboots. The answer is success even when some modems were skipped.
/v2/change_mac_addressRequest body application/json · required
1 random based on mac; 2 exact mac.
1, 2MAC address with colons or dashes.
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
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 |
|---|---|---|
Sent change MAC failed. Please try again later! | positions or mac missing or malformed. | Send positions and mac with mode and mac. |