API Reference / Proxy sessions
Replace a failing proxy address at its provider
Asks the pool's provider for a fresh address in place of one fixed address that is failing its checks or that the provider stopped listing. The replacement is quoted first and made only when the provider charges nothing. A quote above zero is refused with the amount. One replacement is made per session, so sending the call again returns the first one. Accounts on the old address stay on it: the new address joins the pool on the next read of the provider's proxy list, and RebindAssignment or UpdateAssignment then moves an account onto it. Offered for Suborbital static pools.
/ proxies. v1. Proxies/ ReplaceSessionAddressRequest body
application/jsonRequired
Request to ask the pool's provider for a fresh address in place of one failing fixed address, at no charge.
sessionId?stringOpaque 16-byte identifier of the session whose address to replace, base64-encoded in JSON.
Format"byte" base64
Response body
application/json
Success
replacement?ProxiesSessionAddressReplacementThe replacement made for the session, or the one made by an earlier call.
Show attributes
chargedCostCents?stringWhat the provider's balance fell by across the replacement, in US cents. Absent until the replacement is confirmed, or when the provider reports no balance.
Format"int64"
id?stringOpaque 16-byte identifier of the replacement, base64-encoded in JSON.
Format"byte" base64
newAddress?stringThe address the provider gave in its place. Absent until the provider confirmed the replacement, and absent when its answer was lost and a later call found the old address already gone from the account. The new address then joins the pool through the provider's list as usual.
poolId?stringOpaque 16-byte identifier of the session's pool, base64-encoded in JSON.
Format"byte" base64
previousAddress?stringThe address given up, as the provider names it.
providerId?stringOpaque 16-byte identifier of the provider asked for the new address, base64-encoded in JSON.
Format"byte" base64
quotedCostCents?stringWhat the provider quoted for the replacement before it was made, in US cents. Always zero: the call goes ahead only at no charge.
Format"int64"
replacedAt?stringWhen the provider confirmed the replacement. Absent until then.
Format"date-time"
requestedAt?stringWhen the replacement was asked for.
Format"date-time"
requestedBy?stringOpaque 16-byte identifier of the person or API key that asked, base64-encoded in JSON.
Format"byte" base64
sessionId?stringOpaque 16-byte identifier of the session whose address was replaced, base64-encoded in JSON.
Format"byte" base64
status?stringWhether the provider has confirmed the replacement.
Value in"SESSION_"SESSION_
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 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
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/ReplaceSessionAddress" \
-H "Authorization: Bearer $CSTRADER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sessionId": "AY+MIjMzfu6P/05OTk5OTg=="
}'const res = await fetch("https://api.goldmine.to/proxies.v1.Proxies/ReplaceSessionAddress", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.CSTRADER_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"sessionId": "AY+MIjMzfu6P/05OTk5OTg=="
}),
});
const data = await res.json();body := strings.NewReader(`{
"sessionId": "AY+MIjMzfu6P/05OTk5OTg=="
}`)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, "https://api.goldmine.to/proxies.v1.Proxies/ReplaceSessionAddress", 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/ReplaceSessionAddress",
headers={"Authorization": f"Bearer {os.environ['CSTRADER_API_KEY']}"},
json={
"sessionId": "AY+MIjMzfu6P/05OTk5OTg=="
},
)
data = res.json(){
"replacement": {
"id": "AY+MI2ZmfO6P/05OTk5OTg==",
"workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
"sessionId": "AY+MIjMzfu6P/05OTk5OTg==",
"poolId": "AY+MISIifMyN3T09PT09PQ==",
"providerId": "AY+MIBEReqqLuywsLCwsLA==",
"previousAddress": "203.0.113.23",
"newAddress": "198.51.100.183",
"status": "SESSION_ADDRESS_REPLACEMENT_STATUS_REPLACED",
"quotedCostCents": "0",
"chargedCostCents": "0",
"requestedBy": "AY+MHnorfD2eTxorPE1ebw==",
"requestedAt": "2026-11-15T10:07:42Z",
"replacedAt": "2026-11-15T10:07:44Z"
}
}{
"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": "internal",
"message": "An internal server error occurred."
}{
"code": "unavailable",
"message": "The service is temporarily unavailable. Retry with backoff."
}