API Reference / Legacy proxy pools
Update a legacy proxy pool
Updates a legacy proxy pool's name or description. Only the fields you supply are changed. Concurrency is guarded server-side on the row's own version, so no client-supplied version is needed.
/ proxies. v1. Proxies/ UpdateProxyPoolRequest body
application/jsonRequired
Request to rename a legacy proxy pool or change its description. Fields left out are unchanged.
description?stringNew description. Absent keeps the current description.
name?stringNew name. Absent keeps the current name.
poolId?stringOpaque 16-byte identifier of the legacy proxy pool to change, base64-encoded in JSON.
Format"byte" base64
Response body
application/json
Success
proxyPool?ProxyPoolThe legacy pool with the update applied.
Show attributes
createdAt?stringWhen the legacy pool was created.
Format"date-time"
deletedAt?stringWhen the legacy pool was deleted. Absent while it is live.
Format"date-time"
description?stringFree-text description of the legacy pool. May be empty.
id?stringOpaque 16-byte identifier of the legacy proxy pool, assigned on creation. Base64-encoded in JSON.
Format"byte" base64
name?stringThe legacy pool's name, such as "csfloat-scraping".
updatedAt?stringWhen the legacy pool was last changed.
Format"date-time"
version?stringEdit counter, incremented by every change a user makes to the pool.
Format"int64"
workspaceId?stringOpaque 16-byte identifier of the workspace that owns the pool, base64-encoded in JSON.
Format"byte" base64
application/json
The request was malformed, such as a missing required field or an unparseable cursor.
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 resource already exists. The operation was aborted, typically because of a concurrency conflict.
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/UpdateProxyPool" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"poolId": "bGVnYWN5cG9vbDAwMDEAAA==",
"description": "Legacy residential pool for csfloat scraping, EU region"
}'const res = await fetch("https://api.goldmine.to/proxies.v1.Proxies/UpdateProxyPool", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"poolId": "bGVnYWN5cG9vbDAwMDEAAA==",
"description": "Legacy residential pool for csfloat scraping, EU region"
}),
});
const data = await res.json();body := strings.NewReader(`{
"poolId": "bGVnYWN5cG9vbDAwMDEAAA==",
"description": "Legacy residential pool for csfloat scraping, EU region"
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/proxies.v1.Proxies/UpdateProxyPool", 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/UpdateProxyPool",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"poolId": "bGVnYWN5cG9vbDAwMDEAAA==",
"description": "Legacy residential pool for csfloat scraping, EU region"
},
)
data = res.json(){
"proxyPool": {
"id": "bGVnYWN5cG9vbDAwMDEAAA==",
"workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
"name": "legacy-scrapers",
"description": "Legacy residential pool for csfloat scraping, EU region",
"version": "2",
"createdAt": "2026-06-20T12:00:00Z",
"updatedAt": "2026-06-29T11:00:00Z"
}
}{
"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": "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."
}