Sign in
latestOpenAPI 3.1.02026-08-22154287463.4 KB

858365328f92

Proxies

Rename proxy by ID

Update a proxy's name. Proxy names are not unique and are not ID-or-name addressable on this endpoint; duplicate names are allowed. Name-based session-create lookups can remain ambiguous until callers resolve proxies by ID or the API adds a stronger uniqueness contract.

patch/proxies/{id}

Path parameters

idstring required

Request body

namestring required

New proxy name. Proxy names are trimmed and length-checked only; duplicates are allowed because proxies are updated by ID, not by name.

Example request

{
  "name": "my-renamed-proxy"
}

Response

Proxy updated

bypass_hostsstring[]

Hostnames that should bypass the parent proxy and connect directly.

idstring
ip_addressstring

IP address that the proxy uses when making requests.

last_checkedstring date-time

Timestamp of the last health check performed on this proxy.

namestring

Readable name of the proxy.

protocol'http' | 'https'

Protocol to use for the proxy connection.

status'available' | 'unavailable'

Current health status of the proxy.

type'datacenter' | 'isp' | 'residential' | 'mobile' | 'custom' required

Proxy type to use. In terms of quality for avoiding bot-detection, from best to worst: mobile > residential > isp > datacenter.

Example response

{
  "config": {
    "country": "US"
  },
  "ip_address": "192.168.1.1"
}