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

Change settings of several sold proxies at once

Updates only the fields present in the body (or forced with default_FIELD: false) on every id in ids, then restarts those ports. Answers with the updated rows, which contain credentials and API tokens. VLESS and Shadowsocks need a Premium or Business license (HTTP 403).

  • Destructive · confirm first
  • Basic auth
  • Panel API · since v20.8.0
  • Hub: needs owner approval
  • bulkEditSellingProxies
POST/selling/bulk_edit

Request body application/json · required

idsinteger[]required

Sold-proxy ids (id in /selling/shared_proxies).

portTypeintegeroptional

0 HTTP and SOCKS5, 1 HTTP, 2 SOCKS5, 3 VLESS (Xray), 4 Shadowsocks (Xray). 3 and 4 need a Premium or Business license.

One of 0, 1, 2, 3, 4
ipTypeintegeroptional

1 IPv4, 2 IPv6, 3 IPv6 then IPv4, 4 IPv4 then IPv6.

One of 1, 2, 3, 4
expiredDateintegeroptional

Expiry in epoch milliseconds.

ipAuthenticationEntrystringoptional

Comma-separated IPs allowed without a password.

userAuthenticationEntrystringoptional

user:pass entries.

isAutoGenAuthenticationbooleanoptional

Generate random user:pass instead of userAuthenticationEntry.

whitelistLimitAccessEntrystringoptional

Only these domains are reachable.

blacklistLimitAccessEntrystringoptional

These domains are blocked.

bwLimitEnabledintegeroptional
One of 0, 1
bwLimitRateintegeroptional

Mbps.

customDNSstringoptional
maxConnectionintegeroptional
maxConnectionPeriodintegeroptional
idleTimeoutintegeroptional
counterAllLimitintegeroptional
One of 0, 1
counterAllLimitByintegeroptional
One of 1, 2, 3, 4
counterAllQuotaInMBintegeroptional
counterDownloadLimitintegeroptional
One of 0, 1
counterDownloadLimitByintegeroptional
One of 1, 2, 3, 4
counterDownloadQuotaInMBintegeroptional
counterUploadLimitintegeroptional
One of 0, 1
counterUploadLimitByintegeroptional
One of 1, 2, 3, 4
counterUploadQuotaInMBintegeroptional
forceServerResolveDnsbooleanoptional
allowApiRotatebooleanoptional

Let the customer rotate with /selling/rotate.

minSecondRotateintegeroptional

Minimum seconds between customer rotations.

allowApiChangeRotationbooleanoptional

Let the customer set the auto-rotation interval.

intervalRotationintegeroptional

Auto-rotation interval in seconds; 0 off.

minIntervalRotationintegeroptional
sharedEnabledbooleanoptional
tcpOSstringoptional

TCP OS fingerprint profile id (see /selling/tcp_os_profiles).

memostringoptional
tagsstring[]optional
positionintegeroptional

New slot for single-destination proxies.

selected_positionsinteger[]optional

New slots for group proxies.

Responses

Updated rows, or a 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.
VLESS and Shadowsocks require a Premium or Business licenseportType 3 or 4 on a license without Xray selling (HTTP 403).Use portType 0-2 or upgrade the license.
Invalid request [ids not found]!ids is missing or empty (returned in data).Send at least one id.
Invalid idleTimeout, range [1-86400s]idleTimeout outside 1-86400 (returned in data).Use 1-86400 seconds.
Verified against XProxy v21.3.2 on Nov 17, 2026