> ## Documentation Index
> Fetch the complete documentation index at: https://tbd-6fc993ce-hypeship-update-create-pool-guidance.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Proxies

Manage proxy configurations for routing browser traffic. For background on proxy types and when to use each, see [Proxies](/proxies/overview).

## `kernel proxies list`

List available proxy configurations.

| Flag | Description |
| - | - |
| `--output json`, `-o json` | Output raw JSON array. |

## `kernel proxies get <id>`

Show details for a proxy configuration.

| Flag | Description |
| - | - |
| `--output json`, `-o json` | Output raw JSON object. |

## `kernel proxies create`

Create a new proxy configuration. Proxy quality for bot detection avoidance, best to worst: mobile > residential > ISP > datacenter.

| Flag | Description |
| - | - |
| `--type <type>` | `datacenter`, `isp`, `residential`, `mobile`, or `custom`. Required. |
| `--name <name>` | Proxy configuration name. |
| `--protocol <protocol>` | Protocol to use (`http` or `https`; default: `https`). |
| `--country <code>` | ISO 3166 country code or `EU`. ISP proxies support `US`, `SG`, `GB`, `FR`, and `DE`. |
| `--city <name>` | City name or provider alias. Residential and mobile; requires `--country`. |
| `--state <code>` | State/region code. Residential, or US-only for mobile. |
| `--zip <zip>` | ZIP/postal code. Residential only. |
| `--asn <asn>` | Autonomous system number (e.g. `AS15169`). Residential only. |
| `--os <os>` | Operating system (`windows`, `macos`, `android`). Residential only. |
| `--host <host>` | Proxy host address or IP (`custom` type). |
| `--port <port>` | Proxy port (`custom` type). |
| `--username <username>` | Username for proxy authentication (`custom` type). |
| `--password <password>` | Password for proxy authentication (`custom` type). |
| `--bypass-host <hostname>` | Hostname(s) to bypass the proxy and connect directly (repeatable or comma-separated). |
| `--output json`, `-o json` | Output raw JSON object. |

```bash theme={null}
# Datacenter proxy in the US
kernel proxies create --type datacenter --country US --name "US Datacenter"

# ISP proxy with a static exit IP in the United Kingdom
kernel proxies create --type isp --country GB --name "GB ISP"

# Custom proxy server
kernel proxies create --type custom --host proxy.example.com --port 8080 --username myuser --password mypass

# Residential proxy with location
kernel proxies create --type residential --country US --city sanfrancisco --state CA
```

## `kernel proxies update <id>`

Rename a proxy configuration. To change its type or connection settings, recreate the proxy.

| Flag | Description |
| - | - |
| `--name <name>` | New proxy name. Required. |
| `--output json`, `-o json` | Output raw JSON object. |

```bash theme={null}
kernel proxies update prx_01k3m8v2c9w4n7q6 --name us-checkout-proxy
```

## `kernel proxies check <id>`

Run a health check on a proxy to verify it's working and update its status.

| Flag | Description |
| - | - |
| `--url <url>` | Public HTTP or HTTPS URL to test reachability against. |
| `--output json`, `-o json` | Output raw JSON object. |

## `kernel proxies delete <id>`

Delete a proxy configuration.

| Flag | Description |
| - | - |
| `--yes`, `-y` | Skip confirmation prompt. |