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

Turn the Wi-Fi of one or more modems on or off

Use this to switch modem Wi-Fi hotspots. XProxy XH20/XH22 modems set Wi-Fi to state; NextGen Android phones toggle it; other modems are skipped. The answer is success even when modems were skipped.

  • Action · reversible
  • Basic auth
  • Panel API · since v20.8.0
  • Hub: needs owner approval
  • changeWifi
POST/v2/wifi_change_in_bulk

Request body application/json · required

positionsinteger[]required
statebooleanrequired

true turns Wi-Fi on, false turns it off.

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.

statusbooleanrequired

True when the box accepted the request.

msgstringrequired

Outcome code or message (see the operation's error table).

Errors returned in msg

msgMeaningWhat to do
Sent change Wi-Fi failed. Please try again later!positions or state missing.Send both fields.
Verified against XProxy v21.3.2 on Nov 17, 2026