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

# Allowlist de IP

> De onde cada chave pode ser usada

<Note>**Beta** — o contrato da 1.0 está em evolução. Na 1.0 a lista é **da chave**, não da conta.</Note>

Cada chave pode ter uma lista de IPs de onde ela aceita ser usada. Sem lista, a chave vale de qualquer lugar.

```bash theme={null}
curl -X PUT https://api.go.swytchpay.app/v1/ip-allowlist \
  -H "x-api-key: ak_live_xxx" -H "x-api-secret: sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "entries": ["203.0.113.10", "198.51.100.0/24"] }'
# { "ip_allowlist": ["203.0.113.10", "198.51.100.0/24"] }
```

* A lista vale para a **chave que fez a chamada**. Outras chaves da mesma conta não mudam.
* `entries: []` desliga a restrição.
* **Proteção contra se trancar do lado de fora:** ao restringir, o IP de quem está chamando precisa estar na lista
  nova. Se não estiver, a resposta é `400` e nada muda.
* Uma chamada de um IP fora da lista recebe `401` com o código `AUTH_IP_BLOCKED`.