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

# manage_proxies

> Create, retrieve, rename, check, and delete proxy configurations

Manage proxy configurations for routing browser traffic. Proxy quality for bot detection avoidance, best to worst: mobile > residential > ISP > datacenter.

## Actions

| Action | Description |
| - | - |
| `create` | Add a proxy. |
| `list` | List all proxies. |
| `get` | Retrieve a proxy by ID. |
| `rename` | Change a proxy's name. |
| `check` | Test proxy connectivity. |
| `delete` | Remove a proxy. |

## Parameters

| Parameter | Description |
| - | - |
| `action` | Operation to perform: `create`, `list`, `get`, `rename`, `check`, or `delete`. Required. |
| `limit` | (list) Maximum results per page. Must be between 1 and 100. |
| `offset` | (list) Pagination offset. Must be 0 or greater. |
| `type` | (create) Proxy type: `datacenter`, `isp`, `residential`, `mobile`, or `custom`. |
| `name` | (create, rename) Readable name for the proxy. |
| `country` | (create) ISO 3166 country code (e.g., `US`). |
| `state` | (create) Two-letter state code. |
| `city` | (create) City name without spaces (e.g., `sanfrancisco`). Requires `country`. |
| `custom_host` | (create, custom type) Proxy host address. |
| `custom_port` | (create, custom type) Proxy port. |
| `custom_username` | (create, custom type) Auth username. |
| `custom_password` | (create, custom type) Auth password. |
| `proxy_id` | (get, rename, check, delete) Proxy ID. |
| `check_url` | (check) Optional HTTP or HTTPS URL to test through the proxy instead of Kernel's default check target. |

## Example

```json theme={null}
{
  "action": "create",
  "type": "residential",
  "name": "us-residential",
  "country": "US"
}
```