Proxies

List stored proxies

get

Proxies saved in the launcher store. Credentials (username/password) are never returned.

Authorizations

bearerAuth

AuthorizationstringRequired

Permanent JWT from Settings → Automation API.

Responses

200

Proxy summaries.

application/json

Stored proxy without credentials.

idstringOptional

namestringOptional

kindstring · enumOptionalPossible values:

hoststringOptional

portintegerOptional

countrystringOptional

Informational tag (e.g. "US").

401

Missing or invalid Bearer token.

get

/proxies

HTTPcURLJavaScriptPython

GET /proxies HTTP/1.1
Host: 127.0.0.1:40325
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "text",
    "name": "text",
    "kind": "socks5",
    "host": "text",
    "port": 1,
    "country": "text"
  }
]

Add a proxy

post

Adds a proxy to the store (deduped by endpoint). Pass proxy as a string, or explicit host/port (+ kind/username/password).

Authorizations

bearerAuth

AuthorizationstringRequired

Permanent JWT from Settings → Automation API.

Body

application/json

A proxy string OR explicit fields (string wins).

proxystringOptional

scheme://user:pass@host:port or host:port:user:pass.

kindstring · enumOptionalPossible values:

hoststringOptional

portintegerOptional

usernamestringOptional

passwordstringOptional

namestringOptional

countrystringOptional

notesstringOptional

Responses

200

Stored proxy summary.

application/json

Stored proxy without credentials.

idstringOptional

namestringOptional

kindstring · enumOptionalPossible values:

hoststringOptional

portintegerOptional

countrystringOptional

Informational tag (e.g. "US").

400

Unparseable proxy / missing host+port.

application/json

401

Missing or invalid Bearer token.

post

/proxies

HTTPcURLJavaScriptPython

POST /proxies HTTP/1.1
Host: 127.0.0.1:40325
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 137

{
  "proxy": "text",
  "kind": "socks5",
  "host": "text",
  "port": 1,
  "username": "text",
  "password": "text",
  "name": "text",
  "country": "text",
  "notes": "text"
}

{
  "id": "text",
  "name": "text",
  "kind": "socks5",
  "host": "text",
  "port": 1,
  "country": "text"
}

Delete a proxy

delete

Authorizations

bearerAuth

AuthorizationstringRequired

Permanent JWT from Settings → Automation API.

Path parameters

idstringRequired

Responses

200

Deleted.

application/json

deletedbooleanOptionalExample: true

idstringOptional

401

Missing or invalid Bearer token.

delete

/proxies/{id}

HTTPcURLJavaScriptPython

DELETE /proxies/{id} HTTP/1.1
Host: 127.0.0.1:40325
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "deleted": true,
  "id": "text"
}