- API Reference
- Box API
- Modems
Change the MTU, TTL or active SIM slot of one modem
Use this to tune one modem. type picks the setting: mtu saves and applies data.mtu to the interface, ttl saves and applies data.ttl (0 turns TTL rewriting off), sim switches the modem to data.simSlot (dual-SIM modems only; the modem reconnects on the other SIM).
/update_dongle_settingsRequest body application/json · required
Slot number.
mtu, ttl, simMTU, typically 1280-1500. Used with type mtu.
Outgoing TTL; 0 disables. Used with type ttl.
SIM slot to use. Used with type sim.
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.
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 |
|---|---|---|
Dongle not supported! | Unknown type, or the modem cannot switch SIM slots. | Use type mtu, ttl or sim; SIM switch needs a dual-SIM modem. |
Configuration failed! | A field is missing or the value is invalid. | Send pos, type and data with the matching key. |