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

Read the MTU, TTL and active SIM slot of one modem

Use this before POST /update_dongle_settings. Returns the stored MTU (default 1500), TTL (0 means not changed) and the active SIM slot (1 when the modem cannot report it). On an internal error the defaults are returned with status true.

  • Read only
  • Basic auth
  • Panel API · since v20.8.0
  • Hub: routine call
  • getDongleSettings
POST/get_dongle_settings

Request body application/json · required

posintegerrequired

Slot number.

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

Settings.

statusbooleanoptional
dataobjectoptional
data.mtustring | integeroptional
data.ttlintegeroptional
data.simSlotstring | integeroptional
Verified against XProxy v21.3.2 on Nov 17, 2026