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

Swap two slots so a modem moves to another slot number

Use this to reorder modems. Swaps the device data of the two positions; ports, VLESS/Shadowsocks credentials and other slot-bound settings stay with the slot number. Both slots' proxies are taken down and brought up again. Both positions must exist within the licensed modem count.

  • Destructive · confirm first
  • Basic auth
  • Panel API · since v20.9.99
  • Hub: needs owner approval
  • changePosition
POST/v2/change_position

Request body application/json · required

from_positionintegerrequired
to_positionintegerrequired

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; msg is empty on success.

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
Invalid positionA position is below 1 or above the licensed modem count.Use positions within the license.
Positions are the samefrom_position equals to_position.Pick two different slots.
Position info not foundA slot has no record yet.Use slots shown in the panel.
Verified against XProxy v21.3.2 on Nov 17, 2026