API Reference
Dashboard
  1. API Reference
  2. Box API
  3. 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).

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

Request body application/json · required

posintegerrequired

Slot number.

typestringrequired
One of mtu, ttl, sim
dataobjectrequired
data.mtustring | integeroptional

MTU, typically 1280-1500. Used with type mtu.

data.ttlintegeroptional

Outgoing TTL; 0 disables. Used with type ttl.

data.simSlotstring | integeroptional

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.

statusbooleanoptional
msgstringoptional

Errors returned in msg

msgMeaningWhat 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.
Verified against XProxy v21.3.2 on Nov 17, 2026