Proxies

List the project's saved proxies (no passwords: `hasPassword` only)

GET

/v1/proxies

Authorization

headerAuthorizationBearer <token>

An API key (wa_<region>_…) or a dashboard access token.

Response Body

application/json

response

proxies*array<>

Example Request

curl -X GET 'https://api.us.webagent.lookover.ai/v1/proxies'

Example Request

curl -X GET 'https://api.us.webagent.lookover.ai/v1/proxies'

Example ResponseSchema

{
  "proxies": [
    {
      "id": "string",
      "name": "string",
      "protocol": "http",
      "host": "string",
      "port": 1,
      "username": "string",
      "hasPassword": true,
      "bypassHosts": [
        "string"
      ],
      "createdAt": 0
    }
  ]
}

{  "proxies": [    {      "id": "string",      "name": "string",      "protocol": "http",      "host": "string",      "port": 1,      "username": "string",      "hasPassword": true,      "bypassHosts": [        "string"      ],      "createdAt": 0    }  ]}

Save a proxy

POST

/v1/proxies

Save a proxy. The password is sealed and never returned. 400 invalid_input for a host that is, or resolves to, a private, loopback, link-local or metadata address

Authorization

headerAuthorizationBearer <token>

An API key (wa_<region>_…) or a dashboard access token.

Request Body

application/json

body

name*string

Length1 <= length <= 100

protocol*string

Value in"http""https""socks5"

host*string

Lengthlength <= 253

port*integer

Range1 <= value <= 65535

username?string

Length1 <= length <= 256

password?string

Length1 <= length <= 256

bypassHosts?array<>

Itemsitems <= 50

Response Body

application/json

response

id*string

Match^prx_(us|in)_[0-9a-z]{24}$

name*string

Length1 <= length <= 100

protocol*string

Value in"http""https""socks5"

host*string

Lengthlength <= 253

port*integer

Range1 <= value <= 65535

username?string

Length1 <= length <= 256

hasPassword*boolean

bypassHosts*array<>

Itemsitems <= 50

createdAt*integer

Range0 <= value <= 9007199254740991

Example Request

curl -X POST 'https://api.us.webagent.lookover.ai/v1/proxies' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "string",
  "protocol": "http",
  "host": "string",
  "port": 1
}'

Example Request

curl -X POST 'https://api.us.webagent.lookover.ai/v1/proxies' \  -H 'Content-Type: application/json' \  -d '{  "name": "string",  "protocol": "http",  "host": "string",  "port": 1}'

Example ResponseSchema

{
  "id": "string",
  "name": "string",
  "protocol": "http",
  "host": "string",
  "port": 1,
  "username": "string",
  "hasPassword": true,
  "bypassHosts": [
    "string"
  ],
  "createdAt": 0
}

{  "id": "string",  "name": "string",  "protocol": "http",  "host": "string",  "port": 1,  "username": "string",  "hasPassword": true,  "bypassHosts": [    "string"  ],  "createdAt": 0}

Delete a saved proxy

DELETE

/v1/proxies/{id}

Delete a saved proxy. 404 not_found for an unknown or another project's proxy

Authorization

headerAuthorizationBearer <token>

An API key (wa_<region>_…) or a dashboard access token.

Path Parameters

id*string

Match^prx_(us|in)_[0-9a-z]{24}$

Response Body

application/json

response

deleted*boolean

Example Request

curl -X DELETE 'https://api.us.webagent.lookover.ai/v1/proxies/string'

Example Request

curl -X DELETE 'https://api.us.webagent.lookover.ai/v1/proxies/string'

Example ResponseSchema

{
  "deleted": true
}

{  "deleted": true}

Test a saved proxy from the API

POST

/v1/proxies/{id}/test

Test a saved proxy from the API: connects through it and reports {ok, ms, exitIp?, error?}. A failing proxy is a 200 with ok: false and a fixed message. 429 rate_limited per tenant

Authorization

headerAuthorizationBearer <token>

An API key (wa_<region>_…) or a dashboard access token.

Path Parameters

id*string

Match^prx_(us|in)_[0-9a-z]{24}$

Response Body

application/json

response

ok*boolean

ms*integer

Range0 <= value <= 9007199254740991

exitIp?string

Lengthlength <= 45

error?string

Lengthlength <= 500

Example Request

curl -X POST 'https://api.us.webagent.lookover.ai/v1/proxies/string/test'

Example Request

curl -X POST 'https://api.us.webagent.lookover.ai/v1/proxies/string/test'

Example ResponseSchema

{
  "ok": true,
  "ms": 0,
  "exitIp": "string",
  "error": "string"
}

{  "ok": true,  "ms": 0,  "exitIp": "string",  "error": "string"}

List the project's saved proxies (no passwords: `hasPassword` only)Copy Anchor Link

AuthorizationCopy Anchor Link

Response BodyCopy Anchor Link

Save a proxyCopy Anchor Link

AuthorizationCopy Anchor Link

Request BodyCopy Anchor Link

Response BodyCopy Anchor Link

Delete a saved proxyCopy Anchor Link

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Response BodyCopy Anchor Link

Test a saved proxy from the APICopy Anchor Link

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Response BodyCopy Anchor Link

List the project's saved proxies (no passwords: `hasPassword` only)

Authorization

Response Body

Save a proxy

Authorization

Request Body

Response Body

Delete a saved proxy

Authorization

Path Parameters

Response Body

Test a saved proxy from the API

Authorization

Path Parameters

Response Body