Goldmine
Sessions

Create many proxy sessions

POST
/proxies.v1.Proxies/BulkCreateSessions

Adds many proxy sessions to one imported (provider-less) pool in a single transaction, typically when seeding a pool. The operation is idempotent on the pool and session token, so re-running it does not create duplicates.

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/BulkCreateSessions" \  -H "Content-Type: application/json" \  -d '{    "poolId": "AY+MJGZmfd2O7jo6Ojo6Og==",    "sessions": [      {        "token": "sess-1",        "scheme": "http",        "host": "203.0.113.10",        "port": 8080,        "username": "u1",        "password": "p1"      },      {        "token": "sess-2",        "scheme": "socks5",        "host": "203.0.113.11",        "port": 1080,        "username": "u2",        "password": "p2"      }    ]  }'
{
  "sessions": [
    {
      "id": "AY+MJSIie7uMzExMTExMTA==",
      "workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
      "poolId": "AY+MJGZmfd2O7jo6Ojo6Og==",
      "token": "sess-1",
      "scheme": "http",
      "host": "203.0.113.10",
      "port": 8080,
      "username": "u1",
      "enabled": true,
      "version": "1",
      "createdAt": "2026-06-29T10:15:00Z",
      "updatedAt": "2026-06-29T10:15:00Z"
    },
    {
      "id": "AY+MJTMzfMyN3UxMTExMTA==",
      "workspaceId": "AY+MHnorfD2eTxorPE1ebw==",
      "poolId": "AY+MJGZmfd2O7jo6Ojo6Og==",
      "token": "sess-2",
      "scheme": "socks5",
      "host": "203.0.113.11",
      "port": 1080,
      "username": "u2",
      "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": "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."
}

ListSessions

Returns the caller's active sign-in sessions, including device, IP address, and last activity, so they can review and revoke them.

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.