> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eclipseproxy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add whitelist IP

> POST /api/reseller/v1/subusers/{id}/whitelist: whitelist an IP for a subuser

Add an IP to a subuser's whitelist.

## Authentication

Requires a reseller API key. Pass it as `Authorization: Bearer YOUR_API_KEY` or `X-API-Key: YOUR_API_KEY`. See [Reseller overview](/api/reseller/overview#authentication).

## Path parameters

<ParamField path="id" type="string" required>
  The subuser username (full prefixed username, e.g. `MYSTORE_user1`).
</ParamField>

## Body parameters

<ParamField body="ip" type="string" required>
  The IP address to whitelist.
</ParamField>

## Example request

```json theme={"dark"}
{
  "ip": "192.168.1.50"
}
```

## Example response

```json theme={"dark"}
{
  "status": "success",
  "message": "IP added to whitelist",
  "messageCode": "IP_ADDED",
  "data": {
    "username": "MYSTORE_user1",
    "whitelistIPs": ["192.168.1.1", "10.0.0.1", "192.168.1.50"]
  }
}
```

## Errors

* **401** `UNAUTHORIZED`: missing or invalid API key
* **403** `NOT_RESELLER`: account is not a reseller
* **404** `NOT_FOUND`: no subuser with that username