Goldmine
Sessions

Create a proxy session

POST
/proxies.v1.Proxies/CreateSession

Adds a single proxy session to an imported (provider-less) pool - targeting a provider-owned pool is rejected, since that pool's sessions come from its provider's own write path. For static endpoints you provide the scheme, host, port, and credentials; rotation sessions carry only a sticky-session token. The endpoint password is write only and 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

application/json

curl -X POST "https://loading/proxies.v1.Proxies/CreateSession" \  -H "Content-Type: application/json" \  -d '{    "poolId": "AY+MJGZmfd2O7jo6Ojo6Og==",    "token": "sess-abc123",    "scheme": "http",    "host": "203.0.113.10",    "port": 8080,    "username": "user-018f",    "password": "s3cr3t-pass"  }'
{
  "session": {
    "id": "AY+MJREReqqLu0xMTExMTA==",
    "workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
    "poolId": "AY+MJGZmfd2O7jo6Ojo6Og==",
    "token": "sess-abc123",
    "scheme": "http",
    "host": "203.0.113.10",
    "port": 8080,
    "username": "user-018f",
    "enabled": true,
    "version": "1",
    "createdAt": "2026-06-29T10:15:00Z",
    "updatedAt": "2026-06-29T10:15: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": "already_exists",
  "message": "The resource already exists."
}
{
  "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."
}

CountSessions

Returns the number of proxy sessions in your workspace, optionally limited to a single pool and/or filtered by enabled state, so a list page can render a count without loading and counting every row.

DeleteSession

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