IP Allowlist API

Manage the IP access allowlist.

The IP allowlist restricts which source IPs can connect to a proxy. An empty allowlist means no IP restriction.

List Entries

GET/api/proxies/:id/ip-allowlist

bash

curl https://cifp.vril.dev/api/proxies/proxy-id/ip-allowlist \
  -H "Authorization: Bearer cifp_your_api_key"

Response

{
  "entries": [
    {
      "id":          "uuid",
      "cidr":        "203.0.113.0/24",
      "description": "Office network",
      "createdAt":   "2026-06-01T10:00:00Z"
    }
  ],
  "count": 1
}

Add Entry

POST/api/proxies/:id/ip-allowlist

bash

curl -X POST https://cifp.vril.dev/api/proxies/proxy-id/ip-allowlist \
  -H "Authorization: Bearer cifp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "cidr":        "203.0.113.0/24",
    "description": "Office network"
  }'

Field	Required	Description
cidr	Yes	IPv4 CIDR. e.g. 10.0.0.0/8 or 203.0.113.45
description	No	Human-readable label. Max 200 chars.

Returns 409 if the CIDR is already in the allowlist.

Remove Entry

DELETE/api/proxies/:id/ip-allowlist

bash

curl -X DELETE https://cifp.vril.dev/api/proxies/proxy-id/ip-allowlist \
  -H "Authorization: Bearer cifp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"entryId": "uuid-of-the-entry"}'

# Returns 200 {"status":"deleted"}