Proxies

Update a proxy list

Partial update. Same geo rules as create.

patch/proxies/{id}/lists/{lid}

Request

  • Base URL: https://dashboard.voidmob.com/api/v1
  • URL: https://dashboard.voidmob.com/api/v1/proxies/{id}/lists/{lid}
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required
Example:7c4f08c2-2a4f-4c8e-a1d2-9c2b9c8f7e10

Client-supplied key (any string, up to 255 chars) that scopes idempotent replay for write requests. Required on every POST, PATCH, and DELETE. Replays with the same key + same body return the cached response; same key with a different body returns IDEMPOTENCY_CONFLICT. Headers are case-insensitive; both Idempotency-Key and idempotency-key work.

Request body

namestring
countrystring
countriesstring[]
regionstring
citystring
ispstring
zipstring
rotation_period_secondsinteger
rotation_mode'instant' | 'delayed_5s' | 'no_rotation_on_fail'
format'login_pass_host_port' | 'http_url' | 'socks5_url' | 'host_port_login_pass_colon' | 'login_pass_host_port_colon' | 'host_port_login_pass_comma' | 'login_pass_host_port_at'

Saved credential-format preference for the dashboard's list export. API entries are always login:pass@host:port. Each value names the exported line:

  • login_pass_host_port: login:pass@host:port
  • http_url: http://login:pass@host:port
  • socks5_url: socks5://login:pass@host:port
  • host_port_login_pass_colon: host:port:login:pass
  • login_pass_host_port_colon: login:pass:host:port
  • host_port_login_pass_comma: host,port,login,pass
  • login_pass_host_port_at: login@pass@host@port

Deprecated names are still accepted on input but never returned: host_port_login_pass (= host_port_login_pass_comma), host_port (= login_pass_host_port_colon), login_pass_at_host_port (= host_port_login_pass_colon), json (= login_pass_host_port_at).

Response

Updated list.

successtrue required

Example response

{
  "data": {
    "list": {
      "id": "list_01HXYZ123ABC",
      "proxy_id": "prx_8f6a1b2c",
      "credentials": {
        "host": "proxy.voidmob.com",
        "port": 9901
      }
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.