Goldmine
Providers

Update a proxy provider

POST
/proxies.v1.Proxies/UpdateProvider

Updates a connected proxy provider. You can enable or disable it, or rotate its credentials. Only the fields you supply are changed.

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

application/json

application/json

curl -X POST "https://loading/proxies.v1.Proxies/UpdateProvider" \  -H "Content-Type: application/json" \  -d '{    "providerId": "AY+MIBEReqqLuywsLCwsLA==",    "credentials": "d2Vic2hhcmUtdG9rZW4tcm90YXRlZC0yMDI2"  }'
{
  "provider": {
    "id": "AY+MIBEReqqLuywsLCwsLA==",
    "workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
    "type": "PROVIDER_TYPE_WEBSHARE_RESIDENTIAL",
    "targetPoolId": "AY+MISIifMyN3T09PT09PQ==",
    "capabilities": {
      "stateApi": true,
      "supportsSocks5": true
    },
    "state": {
      "bandwidthLimitBytes": "1099511627776",
      "bandwidthUsedBytes": "21474836480",
      "plan": "residential-1tb",
      "geoCount": 195
    },
    "stateRefreshedAt": "2026-06-29T09:00:00Z",
    "enabled": true,
    "version": "4",
    "createdAt": "2026-06-20T12:00:00Z",
    "updatedAt": "2026-06-29T11:00:00Z"
  }
}

{
  "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": "not_found",
  "message": "The requested resource does not exist in this workspace."
}
{
  "code": "aborted",
  "message": "The operation was aborted, typically because of a concurrency conflict."
}
{
  "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."
}

RefreshProviderState

Pulls the latest plan and bandwidth usage from the provider's upstream account and returns the refreshed provider. Providers without an account state interface are returned unchanged.

CountPools

Returns the number of proxy pools in your workspace, so a list page can render a count without loading and counting every row.