API Reference
Dashboard
  1. API Reference
  2. Box API
  3. Selling platform

Let a customer change the operating system the proxy's TCP fingerprint imitates

Sets the TCP OS fingerprint profile of the proxy and restarts the port. Profile ids come from /selling/tcp_os_profiles. Group proxies are refused (in data); other refusals come in message.

  • Action · reversible
  • Selling token (?token=)
  • Public API · since v20.8.24
  • Hub: needs owner approval
  • changeSellingTcpOs
GET/selling/change_tcp_os

Query parameters

tokenstringrequiredsecret

API token of one sold proxy (api_token in /selling/shared_proxies). Give it only to the customer who rents that proxy; anyone with the link can use it.

tcp_osstringrequired

Profile id, 1-8 letters or digits.

Example win3

Authentication

Authenticated only by the sold proxy's API token; the dashboard login and "Basic auth for all API" do not apply.

Responses

Result or refusal.

Errors returned in msg

msgMeaningWhat to do
This function is available on Selling Platform license only. Please contact Administrator!The license does not include the Selling Platform.Upgrade the license.
API Token invalidToken unknown or reset (in message).Ask the seller for the current link; tokens change when reset.
Token and tcp_os parameters are requiredtoken or tcp_os missing.Send both.
Invalid TCP OS profile ID formattcp_os is not 1-8 letters or digits.Use an id from /selling/tcp_os_profiles.
Feature does not allowed for proxy groupThe proxy is a group proxy (in data).Not available for group proxies.
TCP OS profile not foundNo profile with this id.Use an id from /selling/tcp_os_profiles.
Failed to update TCP OSCould not save.Retry; contact the seller.
An error occurred while processing the requestUnexpected error (HTTP 500).Retry; contact the seller.
Verified against XProxy v21.3.2 on Nov 17, 2026