- API Reference
- Box API
- Modems
Change the IMEI of one or more modems
Use this only when the user asks to change modem IMEIs. Option 1 uses IMEIs from imei_list (one per position in order when the counts match, otherwise random picks); option 2 generates an IMEI from a random TAC in phone_models; option 3 generates one from the first 8 digits of based_imei. Each changed modem reboots. Stops at the first modem that rejects the change. Positions without a modem are skipped and still reported as success, and errors inside the loop (for example option 1 without imei_list) are swallowed, so a success answer does not prove any IMEI changed.
/v2/imei_change_in_bulkRequest body application/json · required
1, 2, 3Option 1: text containing 15-digit IMEIs (any separator).
Option 2: TAC codes of phone models.
Option 3: an IMEI or its first 8 digits.
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.
True when the box accepted the request.
Outcome code or message (see the operation's error table).
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.
Unhandled error, for example a non-integer position or a missing required parameter.
Error name, e.g. internal_server_error or bad_request.
Errors returned in msg
| msg | Meaning | What to do |
|---|---|---|
Please choice at least a brand/model! | Option 2 with an empty phone_models list. | Send at least one TAC. |
Please fill valid IMEI! | Option 3 with fewer than 8 digits in based_imei. | Send at least the first 8 digits. |
Sent change IMEI failed. Try again! | A modem rejected the change; later positions were not processed. | Check the modem type supports IMEI change and retry the remaining positions. |