API Reference / Proxy remediations
List proxy remediation records
Returns the proxy remediation records in your workspace, optionally filtered by pool or status. Results are paginated. Pass an empty cursor for the first page and follow the returned cursor for subsequent pages.
/ proxies. v1. Proxies/ ListRemediationsRequest body
application/jsonRequired
Request for one page of the endpoint remediations in the caller's workspace, optionally narrowed by status.
cursor?stringOpaque pagination cursor from a previous ListRemediationsResponse. Empty for the first page.
descending?booleanOrder descending instead of ascending.
filter?RemediationFilterOptional filters applied before pagination.
Show attributes
poolId?stringOptional pool id to limit results to that pool's remediation records. Unset includes remediation records across all pools.
Format"byte" base64
limit?integerMaximum number of remediation records to return. Server caps this at a service-defined upper bound.
Format"int32"
sortField?stringField to order the page by. Unspecified orders by creation time.
Value in"REMEDIATION_"REMEDIATION_
statuses?array<string>Optional status set, the grouping dimension CountRemediations breaks down by. Empty includes every status.
Value in"REMEDIATION_"REMEDIATION_"REMEDIATION_"REMEDIATION_"REMEDIATION_"REMEDIATION_
Response body
application/json
Success
nextCursor?stringCursor to pass as cursor to fetch the next page. Empty when this is the last page.
remediations?array<ProxiesRemediation>The remediations on this page, in the requested order.
Show attributes
accountName?stringSteam account name whose dead endpoint is being replaced.
assignmentId?stringOpaque 16-byte identifier of the account's current assignment, base64-encoded in JSON. Refreshed each time the remediation reopens.
Format"byte" base64
attempts?integerNumber of attempts to acquire an endpoint in the current episode. Capped, and reset when a new episode starts.
Format"int32"
createdAt?stringWhen the remediation record was created.
Format"date-time"
id?stringOpaque 16-byte identifier of the remediation record, base64-encoded in JSON.
Format"byte" base64
lastError?stringThe last failure, recorded when the remediation halts so a member can see what went wrong. Absent otherwise.
newSessionId?stringOpaque 16-byte identifier of the replacement session, base64-encoded in JSON. Absent until a new endpoint is bound.
Format"byte" base64
orderReference?stringThe provider's order or replacement reference, recorded once a purchase is confirmed so it is never bought twice. Absent until then.
poolId?stringOpaque 16-byte identifier of the pool of the account being repaired, base64-encoded in JSON.
Format"byte" base64
providerId?stringOpaque 16-byte identifier of the provider that owns the pool, base64-encoded in JSON. Empty for an imported pool.
Format"byte" base64
spendCents?stringMoney committed to the provider in the current episode, in US cents. Reset when a new episode starts.
Format"int64"
status?stringWhere the replacement stands: needs a new endpoint, acquiring one, bound to a new session, syncing, done, or halted and needing attention.
Value in"REMEDIATION_"REMEDIATION_"REMEDIATION_"REMEDIATION_"REMEDIATION_"REMEDIATION_
updatedAt?stringWhen the remediation record last changed.
Format"date-time"
waitingReason?stringWhy a remediation that needs a new endpoint is waiting rather than proceeding. Unset while it is not waiting.
Value in"REMEDIATION_"REMEDIATION_"REMEDIATION_"REMEDIATION_"REMEDIATION_"REMEDIATION_
workspaceId?stringOpaque 16-byte identifier of the workspace, base64-encoded in JSON.
Format"byte" base64
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 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/ListRemediations" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"limit": 50,
"filter": {
"poolId": "AY+MISIifMyN3T09PT09PQ=="
}
}'const res = await fetch("https://api.goldmine.to/proxies.v1.Proxies/ListRemediations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"limit": 50,
"filter": {
"poolId": "AY+MISIifMyN3T09PT09PQ=="
}
}),
});
const data = await res.json();body := strings.NewReader(`{
"limit": 50,
"filter": {
"poolId": "AY+MISIifMyN3T09PT09PQ=="
}
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/proxies.v1.Proxies/ListRemediations", 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/ListRemediations",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"limit": 50,
"filter": {
"poolId": "AY+MISIifMyN3T09PT09PQ=="
}
},
)
data = res.json(){
"remediations": [
{
"id": "AY+MJmRlZu6P/05OTk5OTg==",
"workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
"assignmentId": "AY+MI0REf/+Kql9fX19fXw==",
"poolId": "AY+MISIifMyN3T09PT09PQ==",
"accountName": "steam_bot_01",
"status": "REMEDIATION_STATUS_HALTED",
"attempts": 3,
"spendCents": "0",
"lastError": "no healthy candidate available",
"createdAt": "2026-06-28T09:00:00Z",
"updatedAt": "2026-06-28T09:05:00Z"
}
],
"nextCursor": "eyJvZmZzZXQiOjUwfQ=="
}{
"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": "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."
}