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.
/ proxies. v1. Proxies/ BulkAssignAccountsToPoolRequest 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?stringOpaque 16-byte identifier of the target pool, base64-encoded in JSON.
Format"byte" base64
Response body
application/json
Success
assignedCount?integerNumber 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?stringThe Steam account name that was not bound to the pool.
reason?stringWhy 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_"BULK_
application/json
The request was malformed, such as a missing required field or an unparseable cursor. The request cannot be carried out in the current system state.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request lacks a valid API key in the Authorization header.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The API key is not allowed to perform this action on this workspace.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The requested resource does not exist in this workspace.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The request was rate limited. Slow down and retry later.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
An internal server error occurred.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
application/json
The service is temporarily unavailable. Retry with backoff.
codestringThe Connect error code, such as "not_found".
details?array<object>Optional machine-readable error details.
messagestringA human-readable description of the error.
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"
]
}'const res = await fetch("https://api.goldmine.to/proxies.v1.Proxies/BulkAssignAccountsToPool", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"poolId": "AY+MISIifMyN3T09PT09PQ==",
"accountNames": [
"steam_bot_01",
"steam_bot_02",
"steam_bot_03"
]
}),
});
const data = await res.json();body := strings.NewReader(`{
"poolId": "AY+MISIifMyN3T09PT09PQ==",
"accountNames": [
"steam_bot_01",
"steam_bot_02",
"steam_bot_03"
]
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/proxies.v1.Proxies/BulkAssignAccountsToPool", body)
if err != nil {
return err
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("CSTRADER_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)import os, requests
res = requests.post(
"https://api.goldmine.to/proxies.v1.Proxies/BulkAssignAccountsToPool",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"poolId": "AY+MISIifMyN3T09PT09PQ==",
"accountNames": [
"steam_bot_01",
"steam_bot_02",
"steam_bot_03"
]
},
)
data = res.json(){
"assignedCount": 3
}{
"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": "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."
}