API Reference
Dashboard
  1. API Reference
  2. Box API
  3. 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.

  • Destructive · confirm first
  • Basic auth
  • Panel API · since v20.8.0
  • Hub: needs owner approval
  • setSlotTcpOs
POST/v2/slot_config/tcp_os_set

Request body application/json · required

positionsinteger[] | integerrequired

Slot numbers; a single number is accepted too.

profilestringrequired

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.

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
This function supported for higher plan. Please upgrade to use!The license does not include TCP/OS spoofing.Upgrade the license plan.
webrtc_requiredcgroup 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.
Verified against XProxy v21.3.2 on Nov 17, 2026