Proxies

Re-buy the plan on a package (adds a full plan of GB and one period)

Adds one full plan allocation of GB on top of whatever is left and extends expires_at by one plan period (from now if the package had already lapsed). Accepted on active, exhausted, and expired packages within 7 days of expiry; the package is active afterwards and the traffic webhooks are re-armed. Charged at the plan's current price; refunded automatically on failure.

On a pool-backed sub-order (proxy.pool_id set), renew instead re-allocates the sub-order's original GB and duration from the pool - not one plan period - at no incremental wallet charge. max_price_cents is ignored. See the Proxy pools tag.

On a Standard dedicated proxy, renew extends an active proxy by one term of its own plan, from the current expires_at, at the price it was bought at with your current discount. max_price_cents is required and checked before charging. An expired dedicated proxy cannot be renewed (409 PROXY_EXPIRED); a Premium one returns 422 NOT_SUPPORTED. proxy.renewed fires on success.

post/proxies/{id}/renew

Request

  • Base URL: https://dashboard.voidmob.com/api/v1
  • URL: https://dashboard.voidmob.com/api/v1/proxies/{id}/renew
  • Auth: HTTP bearer

Path parameters

idstring required

Opaque proxy package identifier.

Example:prx_8f6a1b2c

Headers

Idempotency-Keystring required
Example:7c4f08c2-2a4f-4c8e-a1d2-9c2b9c8f7e10

Client-supplied key (any string, up to 255 chars) that scopes idempotent replay for write requests. Required on every POST, PATCH, and DELETE. Replays with the same key + same body return the cached response; same key with a different body returns IDEMPOTENCY_CONFLICT. Headers are case-insensitive; both Idempotency-Key and idempotency-key work.

Request body

max_price_centsinteger

Required for a catalog (plan-backed) package; ignored for a pool-backed sub-order, where GB is drawn from the pool instead.

Response

Renewed; new expires_at reflected on the proxy. pool_gb_charged is present when the order is pool-backed.

successtrue required

Example response

{
  "data": {
    "proxy": {
      "id": "prx_8f6a1b2c",
      "display_id": "PRX08781M",
      "country": "us",
      "plan_id": "plan_RESI100",
      "pool_id": "pool_3f2b9d3a-1c4e-4a3b-9f0e-6c1d2b3a4f5e",
      "data_gb_total": 100,
      "gateway": {
        "host": "proxy.voidmob.com",
        "port": 10092
      },
      "lists": [
        {
          "id": "list_01HXYZ123ABC",
          "proxy_id": "prx_8f6a1b2c",
          "credentials": {
            "host": "proxy.voidmob.com",
            "port": 9901
          }
        }
      ]
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.