API Reference
Dashboard
  1. API Reference
  2. Box API
  3. Network

Read the DNS servers used by the box and by the proxies

Returns the system DNS list, the DNS list the proxies resolve with, whether proxies use the modem's DNS, and whether VPN clients get the modem DNS.

  • Read only
  • Basic auth
  • Panel API · since v20.8.0
  • Hub: routine call
  • getDnsConfig
GET/update_dns_config

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

DNS settings.

statusbooleanoptional
dataobjectoptional
data.dns_system_liststring | nulloptional

System resolvers, comma separated.

data.dns_proxy_liststring | nulloptional

Resolvers the proxies use, comma separated.

data.using_modem_dnsbooleanoptional
data.vpn_force_reload_dns_serverbooleanoptional
Verified against XProxy v21.3.2 on Nov 17, 2026