Proxy pools

Extend a GB pool at its current rate (self-serve)

Adds gb at the pool's current price_per_gb_cents and pushes valid_until forward by self_extend.adds_days (from now if the pool had lapsed). Charged to the wallet. Refused when self-serve extension is disabled or gb is under self_extend.min_gb. Works on a lapsed pool - this is how a reseller reactivates one.

post/proxy_pools/{id}/extend

Request

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

Path parameters

idstring required

Opaque reseller GB pool identifier.

Example:pool_3f2b9d3a-1c4e-4a3b-9f0e-6c1d2b3a4f5e

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

gbinteger required
max_price_centsinteger required

Response

Extended.

successtrue required

Example response

{
  "data": {
    "pool": {
      "id": "pool_3f2b9d3a-1c4e-4a3b-9f0e-6c1d2b3a4f5e"
    }
  }
}

Changes

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