- API Reference
- Box API
- Network
Change the DNS servers of the box and the proxies
Saves the proxy DNS list and modem-DNS options, writes the system resolver configuration and reloads every proxy. All four fields are required.
/update_dns_configRequest body application/json · required
Resolver IPs separated by commas, spaces or new lines.
Resolver IPs separated by commas, spaces or new lines.
Authentication
Needs a trusted caller (loopback, LAN unless "force auth for local" is on, whitelisted IP, allowed Tailscale) or valid dashboard Basic credentials, which are checked only when dashboard authentication is enabled.
Responses
Result.
True when the box accepted the request.
Outcome code or message (see the operation's error table).
The caller is not trusted (not loopback, LAN, whitelisted or allowed Tailscale) and sent no valid Basic credentials. The body depends on whether "Basic auth for all API" is on. Routes that also use the panel login can answer a plain-text 401 "Unauthorized Access" instead.
Errors returned in msg
| msg | Meaning | What to do |
|---|---|---|
An error when configuration! | A field is missing or writing the resolver settings failed. | Send all four fields and retry. |