Import a proxy list into a pool
Turns an uploaded list of proxies into ready-to-use sessions in one call. It creates a dedicated provider for the import and either adds the sessions to an existing pool or creates a new pool by name. Each row is processed independently and the response reports per-row success or error.
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/ImportProxyList" \ -H "Content-Type: application/json" \ -d '{ "workspaceId": "AY+MHnorfD2eTxorPE1ebw==", "poolName": "imported-proxies", "rows": [ { "scheme": "http", "host": "203.0.113.10", "port": 8080, "username": "u1", "password": "p1" }, { "scheme": "socks5", "host": "203.0.113.11", "port": 1080 } ] }'{
"providerId": "AY+MIBEReqqLuywsLCwsLA==",
"poolId": "AY+MISIifMyN3T09PT09PQ==",
"results": [
{
"sessionId": "AY+MIjMzfu6P/05OTk5OTg=="
},
{
"error": {
"code": "IMPORT_PROXY_LIST_ERROR_CODE_INVALID",
"message": "invalid host"
}
}
]
}{
"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": "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."
}UpdatePool
Updates a proxy pool's name, description, slot count, auto-rotation behavior, capacity caps, or health-probe settings. Only the fields you supply are changed.
QueryProxyUsage
Returns the proxy bandwidth ledger over an inclusive date range, optionally narrowed by provider, pool, session, or account. Each row is a daily total of requests, errors, and bytes transferred. Results are paginated; follow the returned cursor for subsequent pages.