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

Let a customer set which IPs may use the proxy they rent without a password

Replaces the proxy's IP whitelist with the IPs in ips (comma-separated) and restarts the port. Without ips the whitelist is cleared.

  • Destructive · confirm first
  • Selling token (?token=)
  • Public API · since v20.8.0
  • Hub: needs owner approval
  • changeSellingProxyWhitelist
GET/selling/change_whitelist

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.

ipsstringoptional

Comma-separated IPv4 addresses; empty clears the whitelist.

Example 203.0.113.5,203.0.113.6

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.
An error occurred while processing the requestUnexpected error (HTTP 500).Retry; contact the seller.
Verified against XProxy v21.3.2 on Nov 17, 2026