Goldmine
Pools

List proxy pools

POST
/proxies.v1.Proxies/ListPools

Returns the proxy pools in your workspace, fully hydrated with their configuration and server-computed proxy_count. Results are paginated; pass an empty cursor for the first page and follow the returned cursor for subsequent pages.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/proxies.v1.Proxies/ListPools" \  -H "Content-Type: application/json" \  -d '{    "limit": 50  }'
{
  "pools": [
    {
      "id": "AY+MISIifMyN3T09PT09PQ==",
      "workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
      "name": "csfloat-scrapers",
      "description": "Residential pool for csfloat scraping",
      "autoRotateUnhealthy": true,
      "version": "3",
      "createdAt": "2026-06-20T12:00:00Z",
      "updatedAt": "2026-06-29T09:00:00Z",
      "maxAssignmentsPerSession": 1,
      "probeInterval": "300s",
      "unhealthyAfterFailures": 3,
      "probeLatencyCeiling": "5s",
      "proxyCount": 2
    },
    {
      "id": "AY+MJTIyMjIyMjIyMjIyMg==",
      "workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
      "name": "steam-real-accounts",
      "description": "Static proxies for steam account logins",
      "maxSessions": 200,
      "proxyCount": 45,
      "version": "2",
      "createdAt": "2026-06-22T08:00:00Z",
      "updatedAt": "2026-06-29T07:30:00Z"
    }
  ],
  "nextCursor": "eyJvZmZzZXQiOjUwfQ=="
}

{
  "code": "failed_precondition",
  "message": "The request cannot be carried out in the current system state."
}

{
  "code": "unauthenticated",
  "message": "The request lacks a valid API key in the Authorization header."
}
{
  "code": "permission_denied",
  "message": "The API key is not allowed to perform this action on this workspace."
}
{
  "code": "resource_exhausted",
  "message": "The request was rate limited. Slow down and retry later."
}
{
  "code": "internal",
  "message": "An internal server error occurred."
}
{
  "code": "unavailable",
  "message": "The service is temporarily unavailable. Retry with backoff."
}

GetPool

Returns a single proxy pool with its configuration, capacity caps, and health-probe settings.

UpdatePool

Updates a proxy pool's name, description, auto-rotation behavior, capacity caps, or health-probe settings. Only the fields you supply are changed; set a clear_* flag to intentionally return a capacity cap or prober override to its unset default instead of setting a value.