- API Reference
- Box API
- Modems
Set the TCP/OS fingerprint profile of one or more slots
Use this to make proxies look like another OS (Windows, macOS, iOS, Android). Saves the profile per slot and applies it without restarting the proxy; empty slots keep the setting for their next modem. Needs the TCP/OS license feature and cgroup (WebRTC) support enabled on the box.
/v2/slot_config/tcp_os_setRequest body application/json · required
Slot numbers; a single number is accepted too.
profile_id from GET /v2/tcp_os_profiles.
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.
Errors returned in msg
| msg | Meaning | What to do |
|---|---|---|
This function supported for higher plan. Please upgrade to use! | The license does not include TCP/OS spoofing. | Upgrade the license plan. |
webrtc_required | cgroup support is off on the box. | Enable it in system settings first. |
Invalid position! | A position is missing, not an integer, or outside the licensed count. | Send valid slot numbers. |
Invalid profile! | profile is not a known profile id. | Pick one from GET /v2/tcp_os_profiles. |