Sessions
Get a proxy session
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
curl -X POST "https://loading/proxies.v1.Proxies/GetSession" \ -H "Content-Type: application/json" \ -d '{ "workspaceId": "AY+MHnorfD2eTxorPE1ebw==", "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": "invalid_argument",
"message": "The request was malformed, such as a missing required field or an unparseable cursor."
}{
"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."
}DeleteSession
Removes a proxy session from its pool. The session is soft deleted and excluded from future proxy resolution.
ListSessions
Returns the identifiers of proxy sessions in your workspace, 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.