The NextDNS connector lets your AI agent act in each user's NextDNS account. Each user connects their own NextDNS API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 59 tools.
- Tools
- 59
- What they doRead · write · destructive
- 30 · 20 · 930 read20 write9 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the NextDNS connection
In AgentKit > Connections, create a NextDNS connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'nextdns'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize NextDNS:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'nextdns_profiles_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "nextdns"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize NextDNS:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="nextdns_profiles_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their NextDNS credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolnextdns_allowlist_listList a profile's always-allowed domains.Read-onlyList Allowlist
List a profile's always-allowed domains. Returns data, meta. Get the profile ID from nextdns_profiles_list.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_analytics_destinations_getGet a profile's query counts by destination country or by big-tech company (type countries or gafam) for a date range, optionally for one device.Read-onlyGet Analytics: Destinations
Get a profile's query counts by destination country or by big-tech company (type countries or gafam) for a date range, optionally for one device. Returns data, meta. Use nextdns_analytics_series_get for the same data over time.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
cursorstring- Pagination cursor from meta.pagination.cursor. Example: j2k3zl3b4v
devicestring- Device ID, or __UNIDENTIFIED__. Example: 8TD1G
fromstring- Start date (inclusive): ISO 8601, Unix seconds or ms, relative (-6h, -1d, -3M) or a date. Example: -7d
limitinteger- Results per page (1-500, default 10). Example: 50
tostring- End date (exclusive), same formats as from. Example: now
typestring- countries or gafam. One of: countries, gafam. Example: countriesone of
countriesgafam
nextdns_analytics_devices_getGet a profile's query counts by device for a date range, optionally for one device.Read-onlyGet Analytics: Devices
Get a profile's query counts by device for a date range, optionally for one device. Returns data, meta. Use nextdns_analytics_series_get for the same data over time.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
cursorstring- Pagination cursor from meta.pagination.cursor. Example: j2k3zl3b4v
devicestring- Device ID, or __UNIDENTIFIED__. Example: 8TD1G
fromstring- Start date (inclusive): ISO 8601, Unix seconds or ms, relative (-6h, -1d, -3M) or a date. Example: -7d
limitinteger- Results per page (1-500, default 10). Example: 50
tostring- End date (exclusive), same formats as from. Example: now
nextdns_analytics_dnssec_getGet a profile's query counts by DNSSEC validation for a date range, optionally for one device.Read-onlyGet Analytics: DNSSEC
Get a profile's query counts by DNSSEC validation for a date range, optionally for one device. Returns data, meta. Use nextdns_analytics_series_get for the same data over time.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
cursorstring- Pagination cursor from meta.pagination.cursor. Example: j2k3zl3b4v
devicestring- Device ID, or __UNIDENTIFIED__. Example: 8TD1G
fromstring- Start date (inclusive): ISO 8601, Unix seconds or ms, relative (-6h, -1d, -3M) or a date. Example: -7d
limitinteger- Results per page (1-500, default 10). Example: 50
tostring- End date (exclusive), same formats as from. Example: now
nextdns_analytics_domains_getGet a profile's top queried domains, filterable by status, root domain and block reason for a date range, optionally for one device.Read-onlyGet Analytics: Top Domains
Get a profile's top queried domains, filterable by status, root domain and block reason for a date range, optionally for one device. Returns data, meta. Use nextdns_analytics_series_get for the same data over time.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
cursorstring- Pagination cursor from meta.pagination.cursor. Example: j2k3zl3b4v
devicestring- Device ID, or __UNIDENTIFIED__. Example: 8TD1G
fromstring- Start date (inclusive): ISO 8601, Unix seconds or ms, relative (-6h, -1d, -3M) or a date. Example: -7d
limitinteger- Results per page (1-500, default 10). Example: 50
reasonstring- Only domains for this reason ID from the reasons endpoint, e.g. blocklist:nextdns-recommended. Example: blocklist:nextdns-recommended
rootboolean- Group by root domain. Example: true
statusstring- Only domains with this status. One of: default, blocked, allowed. Example: blockedone of
defaultblockedallowed tostring- End date (exclusive), same formats as from. Example: now
nextdns_analytics_encryption_getGet a profile's query counts by encrypted versus unencrypted for a date range, optionally for one device.Read-onlyGet Analytics: Encryption
Get a profile's query counts by encrypted versus unencrypted for a date range, optionally for one device. Returns data, meta. Use nextdns_analytics_series_get for the same data over time.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
cursorstring- Pagination cursor from meta.pagination.cursor. Example: j2k3zl3b4v
devicestring- Device ID, or __UNIDENTIFIED__. Example: 8TD1G
fromstring- Start date (inclusive): ISO 8601, Unix seconds or ms, relative (-6h, -1d, -3M) or a date. Example: -7d
limitinteger- Results per page (1-500, default 10). Example: 50
tostring- End date (exclusive), same formats as from. Example: now
nextdns_analytics_ip_versions_getGet a profile's query counts by IPv4 and IPv6 for a date range, optionally for one device.Read-onlyGet Analytics: IP Versions
Get a profile's query counts by IPv4 and IPv6 for a date range, optionally for one device. Returns data, meta. Use nextdns_analytics_series_get for the same data over time.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
cursorstring- Pagination cursor from meta.pagination.cursor. Example: j2k3zl3b4v
devicestring- Device ID, or __UNIDENTIFIED__. Example: 8TD1G
fromstring- Start date (inclusive): ISO 8601, Unix seconds or ms, relative (-6h, -1d, -3M) or a date. Example: -7d
limitinteger- Results per page (1-500, default 10). Example: 50
tostring- End date (exclusive), same formats as from. Example: now
nextdns_analytics_ips_getGet a profile's query counts by client IP with network and location for a date range, optionally for one device.Read-onlyGet Analytics: Client IPs
Get a profile's query counts by client IP with network and location for a date range, optionally for one device. Returns data, meta. Use nextdns_analytics_series_get for the same data over time.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
cursorstring- Pagination cursor from meta.pagination.cursor. Example: j2k3zl3b4v
devicestring- Device ID, or __UNIDENTIFIED__. Example: 8TD1G
fromstring- Start date (inclusive): ISO 8601, Unix seconds or ms, relative (-6h, -1d, -3M) or a date. Example: -7d
limitinteger- Results per page (1-500, default 10). Example: 50
tostring- End date (exclusive), same formats as from. Example: now
nextdns_analytics_protocols_getGet a profile's query counts by protocol (DoH, DoT, UDP and others) for a date range, optionally for one device.Read-onlyGet Analytics: Protocols
Get a profile's query counts by protocol (DoH, DoT, UDP and others) for a date range, optionally for one device. Returns data, meta. Use nextdns_analytics_series_get for the same data over time.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
cursorstring- Pagination cursor from meta.pagination.cursor. Example: j2k3zl3b4v
devicestring- Device ID, or __UNIDENTIFIED__. Example: 8TD1G
fromstring- Start date (inclusive): ISO 8601, Unix seconds or ms, relative (-6h, -1d, -3M) or a date. Example: -7d
limitinteger- Results per page (1-500, default 10). Example: 50
tostring- End date (exclusive), same formats as from. Example: now
nextdns_analytics_query_types_getGet a profile's query counts by DNS record type for a date range, optionally for one device.Read-onlyGet Analytics: Query Types
Get a profile's query counts by DNS record type for a date range, optionally for one device. Returns data, meta. Use nextdns_analytics_series_get for the same data over time.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
cursorstring- Pagination cursor from meta.pagination.cursor. Example: j2k3zl3b4v
devicestring- Device ID, or __UNIDENTIFIED__. Example: 8TD1G
fromstring- Start date (inclusive): ISO 8601, Unix seconds or ms, relative (-6h, -1d, -3M) or a date. Example: -7d
limitinteger- Results per page (1-500, default 10). Example: 50
tostring- End date (exclusive), same formats as from. Example: now
nextdns_analytics_reasons_getGet a profile's query counts by block reason (blocklist, denylist, native tracker and others) for a date range, optionally for one device.Read-onlyGet Analytics: Block Reasons
Get a profile's query counts by block reason (blocklist, denylist, native tracker and others) for a date range, optionally for one device. Returns data, meta. Use nextdns_analytics_series_get for the same data over time.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
cursorstring- Pagination cursor from meta.pagination.cursor. Example: j2k3zl3b4v
devicestring- Device ID, or __UNIDENTIFIED__. Example: 8TD1G
fromstring- Start date (inclusive): ISO 8601, Unix seconds or ms, relative (-6h, -1d, -3M) or a date. Example: -7d
limitinteger- Results per page (1-500, default 10). Example: 50
tostring- End date (exclusive), same formats as from. Example: now
nextdns_analytics_series_getGet any analytics breakdown as a time series of query counts per window, for charts.Read-onlyGet Analytics Time Series
Get any analytics breakdown as a time series of query counts per window, for charts. Use the nextdns_analytics_*_get tools for totals.
Inputs
metricstringrequired- Analytics endpoint to chart: status, domains, reasons, ips, devices, protocols, queryTypes, ipVersions, dnssec, encryption or destinations. One of: status, domains, reasons, ips, devices, protocols, queryTypes, ipVersions, dnssec, encryption, destinations. Example: statusone of
statusdomainsreasonsipsdevicesprotocolsqueryTypesipVersionsdnssecencryptiondestinations profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
alignmentstring- Window alignment. One of: start, end, clock. Example: endone of
startendclock cursorstring- Pagination cursor from meta.pagination.cursor. Example: j2k3zl3b4v
devicestring- Device ID, or __UNIDENTIFIED__. Example: 8TD1G
fromstring- Start date (inclusive): ISO 8601, Unix seconds or ms, relative (-6h, -1d, -3M) or a date. Example: -7d
intervalstring- Window size in seconds or a duration such as 1d. Example: 1d
limitinteger- Results per page (1-500, default 10). Example: 50
partialsstring- Return partial windows. One of: none, start, end, all. Example: noneone of
nonestartendall statusstring- domains only. One of: default, blocked, allowed. Example: blockedone of
defaultblockedallowed timezonestring- Time zone name for alignment=clock. Example: Europe/Paris
tostring- End date (exclusive), same formats as from. Example: now
typestring- destinations only. One of: countries, gafam. Example: countriesone of
countriesgafam
nextdns_analytics_status_getGet a profile's query counts by status (default, blocked, allowed) for a date range, optionally for one device.Read-onlyGet Analytics: Query Status
Get a profile's query counts by status (default, blocked, allowed) for a date range, optionally for one device. Returns data, meta. Use nextdns_analytics_series_get for the same data over time.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
cursorstring- Pagination cursor from meta.pagination.cursor. Example: j2k3zl3b4v
devicestring- Device ID, or __UNIDENTIFIED__. Example: 8TD1G
fromstring- Start date (inclusive): ISO 8601, Unix seconds or ms, relative (-6h, -1d, -3M) or a date. Example: -7d
limitinteger- Results per page (1-500, default 10). Example: 50
tostring- End date (exclusive), same formats as from. Example: now
nextdns_block_page_settings_getGet a profile's block page setting.Read-onlyGet Block Page Settings
Get a profile's block page setting. Returns data, meta. Get the profile ID from nextdns_profiles_list.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_blocked_tlds_listList a profile's blocked top-level domains.Read-onlyList Blocked TLDs
List a profile's blocked top-level domains. Returns data, meta. Get the profile ID from nextdns_profiles_list.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_blocklists_listList a profile's enabled ad/tracker blocklists.Read-onlyList Blocklists
List a profile's enabled ad/tracker blocklists. Returns data, meta. Get the profile ID from nextdns_profiles_list.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_denylist_listList a profile's blocked domains.Read-onlyList Denylist
List a profile's blocked domains. Returns data, meta. Get the profile ID from nextdns_profiles_list.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_logs_download_getGenerate a CSV export of a profile's logs and return its download URL.Read-onlyGet Logs Download URL
Generate a CSV export of a profile's logs and return its download URL. Returns data, meta. The redirect=0 option is sent so the URL comes back as JSON.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_logs_listList a profile's DNS query logs, newest first, filtered by date, device, status or search text.Read-onlyList Query Logs
List a profile's DNS query logs, newest first, filtered by date, device, status or search text. Returns data, meta. Use nextdns_logs_download_get for a full export.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
cursorstring- Pagination cursor. Example: j2k3zl3b4v
devicestring- Device ID or __UNIDENTIFIED__. Example: 8TD1G
fromstring- Start date (inclusive). Example: -7d
limitinteger- Results per page (10-1000, default 100). Example: 100
rawboolean- Return all query types, not just navigational ones. Example: true
searchstring- Only logs matching this text. Example: facebook
sortstring- Order. One of: asc, desc. Example: descone of
ascdesc statusstring- Status filter. One of: default, error, blocked, allowed. Example: blockedone of
defaulterrorblockedallowed tostring- End date (exclusive). Example: now
nextdns_logs_settings_getGet a profile's query log settings (enabled, retention, storage location, what to drop).Read-onlyGet Log Settings
Get a profile's query log settings (enabled, retention, storage location, what to drop). Returns data, meta. Get the profile ID from nextdns_profiles_list.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_native_tracking_listList a profile's blocked native device trackers (apple, samsung, huawei, windows and others).Read-onlyList Native Tracking Protection
List a profile's blocked native device trackers (apple, samsung, huawei, windows and others). Returns data, meta. Get the profile ID from nextdns_profiles_list.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_parental_categories_listList a profile's blocked content categories.Read-onlyList Blocked Categories
List a profile's blocked content categories. Returns data, meta. Get the profile ID from nextdns_profiles_list.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_parental_control_getGet a profile's parental control settings (SafeSearch, YouTube restricted mode, bypass blocking).Read-onlyGet Parental Control
Get a profile's parental control settings (SafeSearch, YouTube restricted mode, bypass blocking). Returns data, meta. Get the profile ID from nextdns_profiles_list.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_parental_services_listList a profile's blocked apps and services.Read-onlyList Blocked Services
List a profile's blocked apps and services. Returns data, meta. Get the profile ID from nextdns_profiles_list.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_performance_settings_getGet a profile's performance settings (ECS, cache boost, CNAME flattening).Read-onlyGet Performance Settings
Get a profile's performance settings (ECS, cache boost, CNAME flattening). Returns data, meta. Get the profile ID from nextdns_profiles_list.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_privacy_getGet a profile's privacy settings (disguised trackers, affiliate links).Read-onlyGet Privacy
Get a profile's privacy settings (disguised trackers, affiliate links). Returns data, meta. Get the profile ID from nextdns_profiles_list.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_profile_getGet a profile's full configuration: security, privacy, parental control, lists and settings.Read-onlyGet Profile
Get a profile's full configuration: security, privacy, parental control, lists and settings. Returns data, meta. Get the profile ID from nextdns_profiles_list.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_profiles_listList the NextDNS profiles (configurations) in the account.Read-onlyList Profiles
List the NextDNS profiles (configurations) in the account. Returns data, meta. Use this to get the profile ID every other tool needs.
Inputs
cursorstring- Pagination cursor. Example: j2k3zl3b4v
limitinteger- Results per page. Example: 50
nextdns_security_getGet a profile's threat protection settings (threat intelligence, AI detection, Safe Browsing, cryptojacking, DNS rebinding, NRD, DDNS, parking, CSAM).Read-onlyGet Security
Get a profile's threat protection settings (threat intelligence, AI detection, Safe Browsing, cryptojacking, DNS rebinding, NRD, DDNS, parking, CSAM). Returns data, meta. Get the profile ID from nextdns_profiles_list.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_settings_getGet a profile's general settings (Web3 resolution).Read-onlyGet Settings
Get a profile's general settings (Web3 resolution). Returns data, meta. Get the profile ID from nextdns_profiles_list.
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_allowlist_addAdd an entry to a profile's always-allowed domains by domain.WriteAdd to Allowlist
Add an entry to a profile's always-allowed domains by domain. Returns data, meta. Use nextdns_allowlist_remove to remove it.
Inputs
idstringrequired- The domain to add, e.g. goodwebsite.com. Example: goodwebsite.com
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
activeboolean- Whether the entry is active. Example: true
nextdns_allowlist_toggleTurn an entry in a profile's always-allowed domains on or off without removing it.WriteToggle Allowlist Entry
Turn an entry in a profile's always-allowed domains on or off without removing it. Returns data, meta. Use nextdns_allowlist_list to see entries.
- Idempotent
Inputs
activebooleanrequired- Whether the entry is active. Example: true
idstringrequired- The domain to change, e.g. goodwebsite.com. Example: goodwebsite.com
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_block_page_settings_updateChange a profile's block page setting; only the fields you send change.WriteUpdate Block Page Settings
Change a profile's block page setting; only the fields you send change. Returns data, meta. Use nextdns_block_page_settings_get to see current values.
- Idempotent
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
enabledboolean- Show a block page for blocked websites. Example: true
nextdns_blocked_tlds_addAdd an entry to a profile's blocked top-level domains by TLD.WriteAdd to Blocked TLDs
Add an entry to a profile's blocked top-level domains by TLD. Returns data, meta. Use nextdns_blocked_tlds_remove to remove it.
Inputs
idstringrequired- The TLD to add, e.g. ru. Example: ru
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_blocklists_addAdd an entry to a profile's enabled ad/tracker blocklists by blocklist ID.WriteAdd to Blocklists
Add an entry to a profile's enabled ad/tracker blocklists by blocklist ID. Returns data, meta. Use nextdns_blocklists_remove to remove it.
Inputs
idstringrequired- The blocklist ID to add, e.g. oisd. Example: oisd
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_denylist_addAdd an entry to a profile's blocked domains by domain.WriteAdd to Denylist
Add an entry to a profile's blocked domains by domain. Returns data, meta. Use nextdns_denylist_remove to remove it.
Inputs
idstringrequired- The domain to add, e.g. badwebsite.com. Example: badwebsite.com
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
activeboolean- Whether the entry is active. Example: true
nextdns_denylist_toggleTurn an entry in a profile's blocked domains on or off without removing it.WriteToggle Denylist Entry
Turn an entry in a profile's blocked domains on or off without removing it. Returns data, meta. Use nextdns_denylist_list to see entries.
- Idempotent
Inputs
activebooleanrequired- Whether the entry is active. Example: true
idstringrequired- The domain to change, e.g. badwebsite.com. Example: badwebsite.com
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_logs_settings_updateChange a profile's query log settings (enabled, retention, storage location, what to drop); only the fields you send change.WriteUpdate Log Settings
Change a profile's query log settings (enabled, retention, storage location, what to drop); only the fields you send change. Returns data, meta. Use nextdns_logs_settings_get to see current values.
- Idempotent
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
dropobject- What to drop from logs: {"ip": bool, "domain": bool}. Example: {"ip": false, "domain": false}
enabledboolean- Whether query logging is on. Example: true
locationstring- Log storage location. One of: us, eu, gb, ch. Example: euone of
useugbch retentioninteger- Log retention in seconds (1 hour to 2 years). One of: 3600, 21600, 86400, 604800, 2592000, 7776000, 15552000, 31536000, 63072000. Example: 7776000one of
3600216008640060480025920007776000155520003153600063072000
nextdns_native_tracking_addAdd an entry to a profile's blocked native device trackers (apple, samsung, huawei, windows and others) by vendor ID.WriteAdd to Native Tracking Protection
Add an entry to a profile's blocked native device trackers (apple, samsung, huawei, windows and others) by vendor ID. Returns data, meta. Use nextdns_native_tracking_remove to remove it.
Inputs
idstringrequired- The vendor ID to add, e.g. apple. Example: apple
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_parental_categories_addAdd an entry to a profile's blocked content categories by category ID.WriteAdd to Blocked Categories
Add an entry to a profile's blocked content categories by category ID. Returns data, meta. Use nextdns_parental_categories_remove to remove it.
Inputs
idstringrequired- The category ID to add, e.g. porn. Example: porn
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
activeboolean- Whether the entry is active. Example: true
nextdns_parental_categories_toggleTurn an entry in a profile's blocked content categories on or off without removing it.WriteToggle Blocked Categories Entry
Turn an entry in a profile's blocked content categories on or off without removing it. Returns data, meta. Use nextdns_parental_categories_list to see entries.
- Idempotent
Inputs
activebooleanrequired- Whether the entry is active. Example: true
idstringrequired- The category ID to change, e.g. porn. Example: porn
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_parental_control_updateChange a profile's parental control settings (SafeSearch, YouTube restricted mode, bypass blocking); only the fields you send change.WriteUpdate Parental Control
Change a profile's parental control settings (SafeSearch, YouTube restricted mode, bypass blocking); only the fields you send change. Returns data, meta. Use nextdns_parental_control_get to see current values.
- Idempotent
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
block_bypassboolean- Block VPNs, proxies and alternative DNS bypass methods. Example: true
safe_searchboolean- Enforce SafeSearch on search engines. Example: true
youtube_restricted_modeboolean- Enforce YouTube Restricted Mode. Example: true
nextdns_parental_services_addAdd an entry to a profile's blocked apps and services by service ID.WriteAdd to Blocked Services
Add an entry to a profile's blocked apps and services by service ID. Returns data, meta. Use nextdns_parental_services_remove to remove it.
Inputs
idstringrequired- The service ID to add, e.g. tiktok. Example: tiktok
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
activeboolean- Whether the entry is active. Example: true
nextdns_parental_services_toggleTurn an entry in a profile's blocked apps and services on or off without removing it.WriteToggle Blocked Services Entry
Turn an entry in a profile's blocked apps and services on or off without removing it. Returns data, meta. Use nextdns_parental_services_list to see entries.
- Idempotent
Inputs
activebooleanrequired- Whether the entry is active. Example: true
idstringrequired- The service ID to change, e.g. tiktok. Example: tiktok
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_performance_settings_updateChange a profile's performance settings (ECS, cache boost, CNAME flattening); only the fields you send change.WriteUpdate Performance Settings
Change a profile's performance settings (ECS, cache boost, CNAME flattening); only the fields you send change. Returns data, meta. Use nextdns_performance_settings_get to see current values.
- Idempotent
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
cache_boostboolean- Cache boost (minimum TTL). Example: true
cname_flatteningboolean- CNAME flattening. Example: true
ecsboolean- Anonymized EDNS Client Subnet. Example: true
nextdns_privacy_updateChange a profile's privacy settings (disguised trackers, affiliate links); only the fields you send change.WriteUpdate Privacy
Change a profile's privacy settings (disguised trackers, affiliate links); only the fields you send change. Returns data, meta. Use nextdns_privacy_get to see current values.
- Idempotent
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
allow_affiliateboolean- Allow affiliate and tracking links. Example: true
disguised_trackersboolean- Block disguised third-party trackers. Example: true
nextdns_profile_createCreate a profile with a name and optional security, privacy, parental control, allow/deny list and settings objects.WriteCreate Profile
Create a profile with a name and optional security, privacy, parental control, allow/deny list and settings objects. Returns data, meta. Returns the new profile ID.
Inputs
namestringrequired- Profile name. Example: Home network
allowlistarray- Allowlist. Example: [{"id": "goodwebsite.com", "active": true}]
denylistarray- Denylist. Example: [{"id": "badwebsite.com", "active": true}]
parental_controlobject- Parental Control. Example: {"safeSearch": true}
privacyobject- Privacy. Example: {"blocklists": [{"id": "nextdns-recommended"}]}
securityobject- Security. Example: {"threatIntelligenceFeeds": true}
settingsobject- Settings. Example: {"logs": {"enabled": true}}
nextdns_profile_updateRename a profile.WriteRename Profile
Rename a profile. Returns data, meta. Use the section tools (for example nextdns_security_update) to change settings.
- Idempotent
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
namestring- Profile name. Example: Home network
nextdns_security_updateChange a profile's threat protection settings (threat intelligence, AI detection, Safe Browsing, cryptojacking, DNS rebinding, NRD, DDNS, parking, CSAM); only the fields you send change.WriteUpdate Security
Change a profile's threat protection settings (threat intelligence, AI detection, Safe Browsing, cryptojacking, DNS rebinding, NRD, DDNS, parking, CSAM); only the fields you send change. Returns data, meta. Use nextdns_security_get to see current values.
- Idempotent
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
ai_threat_detectionboolean- AI-driven threat detection (also covers typosquatting, IDN homographs and DGA). Example: true
cryptojackingboolean- Block cryptojacking domains. Example: true
csamboolean- Block child sexual abuse material. Example: true
ddnsboolean- Block dynamic DNS hostnames. Example: true
dns_rebindingboolean- Block DNS rebinding attacks. Example: true
google_safe_browsingboolean- Block malware and phishing domains flagged by Google Safe Browsing. Example: true
nrdboolean- Block newly registered domains. Example: true
parkingboolean- Block parked domains. Example: true
threat_intelligence_feedsboolean- Block domains from threat intelligence feeds. Example: true
nextdns_settings_updateChange a profile's general settings (Web3 resolution); only the fields you send change.WriteUpdate Settings
Change a profile's general settings (Web3 resolution); only the fields you send change. Returns data, meta. Use nextdns_settings_get to see current values.
- Idempotent
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
web3boolean- Resolve Web3 domains (ENS, Unstoppable Domains). Example: true
nextdns_allowlist_removeRemove an entry from a profile's always-allowed domains.DestructiveRemove from Allowlist
Remove an entry from a profile's always-allowed domains. Returns data, meta. Use nextdns_allowlist_list to see entries.
- Idempotent
Inputs
idstringrequired- The domain to remove, e.g. goodwebsite.com. Example: goodwebsite.com
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_blocked_tlds_removeRemove an entry from a profile's blocked top-level domains.DestructiveRemove from Blocked TLDs
Remove an entry from a profile's blocked top-level domains. Returns data, meta. Use nextdns_blocked_tlds_list to see entries.
- Idempotent
Inputs
idstringrequired- The TLD to remove, e.g. ru. Example: ru
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_blocklists_removeRemove an entry from a profile's enabled ad/tracker blocklists.DestructiveRemove from Blocklists
Remove an entry from a profile's enabled ad/tracker blocklists. Returns data, meta. Use nextdns_blocklists_list to see entries.
- Idempotent
Inputs
idstringrequired- The blocklist ID to remove, e.g. oisd. Example: oisd
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_denylist_removeRemove an entry from a profile's blocked domains.DestructiveRemove from Denylist
Remove an entry from a profile's blocked domains. Returns data, meta. Use nextdns_denylist_list to see entries.
- Idempotent
Inputs
idstringrequired- The domain to remove, e.g. badwebsite.com. Example: badwebsite.com
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_logs_clearDelete all of a profile's query logs.DestructiveClear Query Logs
Delete all of a profile's query logs. Returns data, meta. This cannot be undone. Get the profile ID from nextdns_profiles_list.
- Idempotent
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_native_tracking_removeRemove an entry from a profile's blocked native device trackers (apple, samsung, huawei, windows and others).DestructiveRemove from Native Tracking Protection
Remove an entry from a profile's blocked native device trackers (apple, samsung, huawei, windows and others). Returns data, meta. Use nextdns_native_tracking_list to see entries.
- Idempotent
Inputs
idstringrequired- The vendor ID to remove, e.g. apple. Example: apple
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_parental_categories_removeRemove an entry from a profile's blocked content categories.DestructiveRemove from Blocked Categories
Remove an entry from a profile's blocked content categories. Returns data, meta. Use nextdns_parental_categories_list to see entries.
- Idempotent
Inputs
idstringrequired- The category ID to remove, e.g. porn. Example: porn
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_parental_services_removeRemove an entry from a profile's blocked apps and services.DestructiveRemove from Blocked Services
Remove an entry from a profile's blocked apps and services. Returns data, meta. Use nextdns_parental_services_list to see entries.
- Idempotent
Inputs
idstringrequired- The service ID to remove, e.g. tiktok. Example: tiktok
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
nextdns_profile_deleteDelete a profile and its logs.DestructiveDelete Profile
Delete a profile and its logs. Returns data, meta. Get the profile ID from nextdns_profiles_list.
- Idempotent
Inputs
profilestringrequired- NextDNS profile ID (the 6-character ID in the dashboard URL, e.g. abc123). List profiles with nextdns_profiles_list. Example: abc123
No tools match.