Skip to main content

Changelog

This article contains the changelog for AdGuard DNS API.

v1.10​

Released on December 12, 2024

Added a new DNS server setting — block_chrome_prefetch. It disables Private prefetch proxy in Chrome. When this feature is enabled, Chrome will sometimes prefetch links on the Google Search results page and other participating websites even before the user clicks them.

v1.9​

Released on July 11, 2024

  • Added automatic device connection functionality:
    • New DNS server setting — auto_connect_devices_enabled, allowing approval for auto-connecting devices through a specific link type
    • New field in Device — auto_device, indicating that the device is automatically connected
  • Replaced int with long for queries in CategoryQueriesStats, for used in AccountLimits, and for blocked and queries in QueriesStats

v1.8​

Released on April 20, 2024

  • Added support for DNS-over-HTTPS with authentication:
    • New operation — reset DNS-over-HTTPS password for device
    • New device setting — detect_doh_auth_only. Disables all DNS connection methods except DNS-over-HTTPS with authentication
    • New field in DeviceDNSAddresses — dns_over_https_with_auth_url. Indicates the URL to use when connecting using DNS-over-HTTPS with authentication

v1.7​

Released on March 11, 2024

  • Added dedicated IPv4 addresses functionality:
    • Dedicated IPv4 addresses can now be used on devices for DNS server configuration
    • Dedicated IPv4 address is now associated with the device it is linked to, so that queries made to this address are logged for that device
  • Added new operations:
    • List all available dedicated IPv4 addresses
    • Allocate new dedicated IPv4 address
    • Link an available IPv4 address to a device
    • Unlink an IPv4 address from a device
    • Request info on dedicated addresses associated with a device
  • Added new limits to Account limits:
    • dedicated_ipv4 provides information about the amount of already allocated dedicated IPv4 addresses, as well as the limit on them
  • Removed deprecated field of DNSServerSettings:
    • safebrowsing_enabled

v1.6​

Released on January 22, 2024

  • Added new Access settings section for DNS profiles (access_settings). By customizing these fields, you’ll be able to protect your AdGuard DNS server from unauthorized access:

    • allowed_clients — here you can specify which clients can use your DNS server. This field will have priority over the blocked_clients field
    • blocked_clients — here you can specify which clients are not allowed to use your DNS server
    • blocked_domain_rules — here you can specify which domains are not allowed to access your DNS server, as well as define such domains with wildcard and DNS filtering rules

  • Added new limits to Account limits:

    • access_rules provides the sum of currently used blocked_clients and blocked_domain_rules values, as well as the limit on access rules
    • user_rules shows the amount of created user rules, as well as the limit on them

  • Added a new ip_log_enabled setting to log client IP addresses and domains

  • Added new error code FIELD_REACHED_LIMIT to indicate when limits have been reached:

    • For the total number of blocked_clients and blocked_domain_rules in access settings
    • For rules in custom user rules settings

v1.5​

Released on June 16, 2023

  • Added a new block_nrd setting and grouped all security-related settings in one place

Model for safebrowsing settings changed​

From:

{
   "enabled": true
}

To:

{
   "enabled": true,
   "block_dangerous_domains": true,
   "block_nrd": false
}

where enabled now controls all settings in the group, block_dangerous_domains is the previous enabled model field, and block_nrd is a setting that blocks newly registered domains.

Model for saving server settings changed​

From:

{
  "protection_enabled" : true,
  "safebrowsing_enabled" : true,
  ..
}

to:

{
  "protection_enabled" : true,
  "safebrowsing_settings" : {
     "enabled": true,
     "block_dangerous_domains": true,
     "block_nrd": false
  }
  ..
}

here a new field safebrowsing_settings is used instead of the deprecated safebrowsing_enabled, whose value is stored in block_dangerous_domains.

v1.4​

Released on March 29, 2023

  • Added configurable option for blocking response: default (0.0.0.0), REFUSED, NXDOMAIN or custom IP address

v1.3​

Released on December 13, 2022

  • Added method to get account limits

v1.2​

Released on October 14, 2022

  • Added new protocol types DNS and DNSCRYPT. Deprecating the PLAIN_TCP, PLAIN_UDP, DNSCRYPT_TCP and DNSCRYPT_UDP that will be removed later

v1.1​

Released on July 7, 2022

  • Added methods to retrieve statistics by time, domains, companies and devices
  • Added method for updating device settings
  • Fixed required fields definition

v1.0​

Released on February 22, 2022

  • Added authentication
  • CRUD operations with devices and DNS servers
  • Query log
  • Downloading DoH and DoT .mobileconfig
  • Filter lists and web services