Skip to content

API Reference / Proxy assignments

Create many proxy assignments

Binds many accounts to proxy sessions in one call. Each row is committed independently and the response reports per-row success or a typed error, so one bad row does not fail the whole batch. The operation is idempotent per account: a row whose account is already bound to the same pool converges on the existing assignment as a no-op success, while a row whose account is already bound to a different pool reports ALREADY_EXISTS.

POST/proxies.v1.Proxies/BulkCreateAssignment

Request body

application/jsonRequired

Request to create many proxy assignments in one call, up to 10000. Each input succeeds or fails on its own.

assignments?array<BulkCreateAssignmentInput>

The assignments to create, at most 10000. More is rejected with invalid_argument.

Show attributes
accountName?string

Steam account name to bind. Surrounding whitespace is trimmed.

pinned?boolean

True keeps the account on this session. It is never rotated automatically.

poolId?string

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

Format"byte" base64

sessionIdstring

Opaque 16-byte identifier of the session to bind, base64-encoded in JSON. Required, and must belong to the pool.

Format"byte" base64

Response body

application/json

Success

results?array<BulkCreateAssignmentResult>

The outcome of each input, in request order.

Show attributes
assignmentId?string

Opaque 16-byte identifier of the assignment created for this input, base64-encoded in JSON. Set when the input succeeded.

Format"byte" base64

error?BulkCreateAssignmentError

Why this input failed. Set when it failed. Other inputs are unaffected.

Show attributes
code?string

The kind of failure: the account is already assigned, the input is invalid, the session or pool does not exist, or an internal error.

Value in"BULK_CREATE_ASSIGNMENT_ERROR_CODE_ALREADY_EXISTS""BULK_CREATE_ASSIGNMENT_ERROR_CODE_INVALID""BULK_CREATE_ASSIGNMENT_ERROR_CODE_SESSION_NOT_FOUND""BULK_CREATE_ASSIGNMENT_ERROR_CODE_POOL_NOT_FOUND""BULK_CREATE_ASSIGNMENT_ERROR_CODE_INTERNAL"

message?string

Human-readable detail of the failure.

curl -X POST "https://api.goldmine.to/proxies.v1.Proxies/BulkCreateAssignment" \
  -H "Authorization: Bearer $CSTRADER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assignments": [
      {
        "poolId": "AY+MISIifMyN3T09PT09PQ==",
        "sessionId": "AY+MIjMzfu6P/05OTk5OTg==",
        "accountName": "steam_bot_01",
        "pinned": true
      },
      {
        "poolId": "AY+MISIifMyN3T09PT09PQ==",
        "sessionId": "AY+MIkREeqqLu19fX19fXw==",
        "accountName": "steam_bot_02"
      }
    ]
  }'
{
  "results": [
    {
      "assignmentId": "AY+MI0REf/+Kql9fX19fXw=="
    },
    {
      "error": {
        "code": "BULK_CREATE_ASSIGNMENT_ERROR_CODE_ALREADY_EXISTS",
        "message": "assignment already exists for this pool and account"
      }
    }
  ]
}