- API Reference
- Box API
- 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.
POST
/selling/renew_proxyRequest body application/json · required
idsinteger[]required
Sold-proxy ids (id in /selling/shared_proxies).
period_valueintegerrequired
period_typestringrequired
One of
days, weeks, monthsreset_countersbooleanoptional
Default
falseResponses
Renewal result, or a refusal.
The caller is not trusted (not loopback, LAN, whitelisted or allowed Tailscale) and sent no valid Basic credentials. The body depends on whether "Basic auth for all API" is on. Routes that also use the panel login can answer a plain-text 401 "Unauthorized Access" instead.
Unexpected error.
statusbooleanoptional
messagestringoptional
datastringoptional
Errors returned in msg
| msg | Meaning | What 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 provided | ids is missing or empty. | Send at least one id. |
period_value and period_type are required | One of them is missing. | Send both. |
Period value must be a positive integer | period_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 days | Use a shorter period. |
Renewal failed | Unexpected error (HTTP 500). | Check the box logs. |