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

Renew sold proxies for another period, optionally resetting their data counters

Extends each listed proxy by period_value period_type (max 3650 days, 520 weeks or 120 months), records it in the renewal history under the dashboard user, and with reset_counters zeroes their data counters. Ports stopped by expiry start again. status is true when at least one proxy was renewed; data.failed lists the others with a reason.

  • Destructive · confirm first
  • Basic auth
  • Panel API · since v21.0.5
  • Hub: needs owner approval
  • renewSellingProxies
POST/selling/renew_proxy

Request body application/json · required

idsinteger[]required

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

period_valueintegerrequired
period_typestringrequired
One of days, weeks, months
reset_countersbooleanoptional
Default false

Responses

Renewal result, 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.
No proxy IDs providedids is missing or empty.Send at least one id.
period_value and period_type are requiredOne of them is missing.Send both.
Period value must be a positive integerperiod_value is not a positive integer.Send an integer of 1 or more.
Period type must be 'days', 'weeks', or 'months'Unknown period_type.Use days
Period value exceeds maximum (N period_type)More than 3650 daysUse a shorter period.
Renewal failedUnexpected error (HTTP 500).Check the box logs.
Verified against XProxy v21.3.2 on Nov 17, 2026