ONonkernel
Proxies

Rename proxy by ID

Update a proxy's name. Proxy names are not unique and duplicate names are allowed.

patch/proxies/{id_or_name}

Request

  • Base URL
    https://api.onkernel.com
  • URL
    https://api.onkernel.com/proxies/{id_or_name}
  • Auth
    HTTP bearer

Path parameters

id_or_namestring required

Proxy ID. Name-based addressing is supported only for retrieval.

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 is deprecated; use isp instead. Existing datacenter proxies remain supported.

Example response

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

Changes

No recorded changes to this operation across all 76 revisions of this API.