Goldmine
Sessions

Get a proxy session

POST
/proxies.v1.Proxies/GetSession

Returns a single proxy session with its endpoint details and status. The session password is never returned.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://loading/proxies.v1.Proxies/GetSession" \  -H "Content-Type: application/json" \  -d '{    "sessionId": "AY+MIjMzfu6P/05OTk5OTg=="  }'
{
  "session": {
    "id": "AY+MIjMzfu6P/05OTk5OTg==",
    "workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
    "poolId": "AY+MISIifMyN3T09PT09PQ==",
    "providerId": "AY+MIBEReqqLuywsLCwsLA==",
    "token": "sess-abc123",
    "scheme": "http",
    "host": "203.0.113.10",
    "port": 8080,
    "username": "user-018f",
    "enabled": true,
    "version": "2",
    "createdAt": "2026-06-20T12:00:00Z",
    "updatedAt": "2026-06-29T09:00:00Z"
  }
}

{
  "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."
}

DeleteSession

Removes a proxy session from its pool. The session is soft deleted and excluded from future proxy resolution.

ListSessions

Returns the proxy sessions in your workspace, fully hydrated with their endpoint details and latest health verdict, optionally limited to a single pool. Results are paginated; pass an empty cursor for the first page and follow the returned cursor for subsequent pages.