Goldmine
Proxies

Create many proxies

POST
/proxies.v1.Proxies/BulkCreateProxies

Adds many proxies to your workspace's legacy proxy inventory in one call. Each row is processed independently and the response reports per-row success or a typed error, so one bad or duplicate row does not fail the whole batch. A proxy is unique per workspace on its ip and port; a row naming a combination that already exists reports ALREADY_EXISTS instead of creating a duplicate.

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

curl -X POST "https://loading/proxies.v1.Proxies/BulkCreateProxies" \  -H "Content-Type: application/json" \  -d '{    "proxies": [      {        "scheme": "http",        "ip": "203.0.113.10",        "port": 8080,        "user": "legacyproxyuser",        "password": "s3cr3t-pass"      },      {        "scheme": "http",        "ip": "203.0.113.10",        "port": 8080      }    ]  }'
{
  "results": [
    {
      "proxy": {
        "scheme": "http",
        "ip": "203.0.113.10",
        "port": 8080,
        "user": "legacyproxyuser",
        "id": "bGVnYWN5cHJveHkwMDEAAA==",
        "workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
        "enabled": true,
        "version": "1",
        "createdAt": "2026-06-29T10:15:00Z",
        "updatedAt": "2026-06-29T10:15:00Z"
      }
    },
    {
      "error": {
        "code": "BULK_CREATE_PROXY_ERROR_CODE_ALREADY_EXISTS",
        "message": "proxy already exists"
      }
    }
  ]
}
{
  "code": "invalid_argument",
  "message": "The request was malformed, such as a missing required field or an unparseable cursor."
}
{
  "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."
}

UpdateAssignment

Updates a proxy assignment, such as rebinding the account to a different session or changing whether it is pinned. Only the fields you supply are changed.

ListProxies

Returns the proxies in your workspace that fall within a proportional range of the full sorted list, expressed as two fractions between 0 and 1 (0.0 is the first proxy, 1.0 is past the last). This is the legacy proxy inventory that coexists with the newer Provider and Pool model until the csfloat cutover removes it. Each proxy's password is never returned.