Control API
hold launches a small HTTP control API alongside the DNS server. It provides
the following POST endpoints:
| Endpoint | Action |
|---|---|
/cache/clear |
Clear cached DNS responses. |
/blocking/refresh |
Discard the cached download, fetch the blocklist again, and clear cached DNS responses. |
/blocking/toggle |
Enable or disable blocking and clear cached DNS responses. |
No built-in security
The API has no built-in authentication or authorization. Do not expose it directly to an untrusted network. If remote access is required, put it behind a suitably configured reverse proxy that adds authentication, access control, and transport security.