Skip to content

API Reference / Proxy assignments

Assign many accounts to a proxy pool

Binds many accounts to a proxy pool in one call so a workspace's accounts start using its proxies. Each account is bound to the pool and the specific proxy is chosen automatically on first use, so you never pick a session. An account already bound to the pool is left as is, and an account bound to a different pool is moved to this one. An account pinned to a different pool is left untouched and excluded from the count instead. Unpin it first. The response reports how many accounts are now bound to the pool.

POST/proxies.v1.Proxies/BulkAssignAccountsToPool

Request body

application/jsonRequired

Request to bind many Steam accounts to one pool. Each account waits without a session until its first proxy lookup. Unpinned accounts in other pools move over. Repeating the request changes nothing further.

accountNames?array<string>

Steam account names to bind to the pool. Duplicates are treated as one.

poolId?string

Opaque 16-byte identifier of the target pool, base64-encoded in JSON.

Format"byte" base64

Response body

application/json

Success

assignedCount?integer

Number of requested accounts now bound to the pool, whether newly bound, moved from another pool or already bound.

Format"int32"

excludedAccounts?array<BulkAssignAccountsToPoolExclusion>

The requested accounts that were not bound, each with the reason.

Show attributes
accountName?string

The Steam account name that was not bound to the pool.

reason?string

Why it was left out: it is pinned in another pool, so unpin it first, or a concurrent request bound it to another pool, so retry.

Value in"BULK_ASSIGN_ACCOUNTS_TO_POOL_EXCLUSION_REASON_PINNED_TO_ANOTHER_POOL""BULK_ASSIGN_ACCOUNTS_TO_POOL_EXCLUSION_REASON_LOST_BIND_RACE"

curl -X POST "https://api.goldmine.to/proxies.v1.Proxies/BulkAssignAccountsToPool" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "poolId": "AY+MISIifMyN3T09PT09PQ==",
    "accountNames": [
      "steam_bot_01",
      "steam_bot_02",
      "steam_bot_03"
    ]
  }'
{
  "assignedCount": 3
}