Read DNS filtering policy and usage, then change block lists with approval
Connect DNSFilter and Luumen can read your categories, policies, IP and MAC address records, and organization usage metrics while you work in the terminal. When a domain needs blocking or a category needs adding to a policy, Luumen shows the exact change first and asks before it writes. Authentication is by API key.
170 tools: 120 read, 50 write. Reads answer instantly. Writes require approval by default. Everything is logged.
ReadCheck User Agent Bulk Updates Has MixedCheck if user agent attributes are mixed in a bulk selection.
ReadCreate CyberSight CSV ExportCreates a CyberSight CSV export record to track export of CyberSight report information.
ReadGet API KeyRetrieve detailed information about a specific API key by its ID.
ReadGet Application CategoryRetrieves detailed information about a specific DNSFilter application category by its ID.
ReadGet Billing AddressRetrieves the billing address for a specific DNSFilter organization.
ReadGet Billing InformationRetrieves billing records for a specific DNSFilter organization.
ReadGet CategoryGet basic information of a specific category.
ReadGet IP AddressRetrieves detailed information for a specific IP address record by its ID.
ReadGet MAC AddressRetrieves detailed information for a specific MAC address record by its ID.
ReadGet Organization Usage MetricsRetrieves usage metrics for a DNSFilter organization over a specified date range.
ReadGet Organization Usage Detailed MetricsRetrieves detailed usage metrics for a specific DNSFilter organization.
ReadGet My IP AddressRetrieve the requester's IP address as reported by DNSFilter API.
ReadGet Networks Bulk Create StatusCheck the status of a bulk network creation job.
ReadGet Networks Bulk Destroy StatusCheck the status of a bulk network destroy operation.
ReadGet Networks Bulk Update StatusCheck the status of a bulk network update job.
ReadGet Networks CSV ExportRetrieves a networks CSV export by its ID.
ReadGet NotesRetrieve notes associated with a specific resource (policy, MSP, or organization) and domain.
ReadGet OrganizationGet basic information of a specific organization by ID.
ReadGet Organization UserRetrieve user details and permissions for a specific organization.
ReadGet PolicyGet basic information of the specified policy.
ReadGet Policy Permissive ModeRetrieve the permissive mode setting for a specific policy.
ReadGet Policy IPRetrieves basic information for a specific Policy IP by its ID.
ReadGet Scheduled Report PreviewRetrieve a specific scheduled report preview by its ID.
ReadGet UserGet basic information of a specified user by ID.
ReadGet User Agent CleanupGet the specific user agent cleanup by ID.
ReadGet User Agent CSV ExportRetrieve a specific user agent CSV export by its ID.
ReadGet User Agents Uninstall PINGet the uninstall PIN for an organization's user agents.
ReadList All Agent Local UsersGet all agent local users associated with a user organization.
ReadList All Block PagesRetrieves all block pages associated with the current user.
ReadList All IP AddressesRetrieves one page of IP addresses across all networks in your organization.
ReadList API KeysRetrieves the list of API keys associated with the authenticated user.
ReadList Application CategoriesRetrieves all available application categories from DNSFilter.
ReadList All ApplicationsList all applications basic information including deleted ones.
ReadList BillingRetrieve payment method information from Stripe for a DNSFilter organization.
ReadList All Categories (Including Internal)List all categories including internal categories from DNSFilter.
ReadList Current UserFetch information about the currently authenticated user.
ReadList CyberSight Activity TypesRetrieve all available CyberSight activity types.
ReadList Domains Bulk LookupRetrieves domain information and category classifications for multiple FQDNs in a single request.
ReadList Domains User LookupLook up all domains associated with a particular FQDN.
ReadList Enterprise ConnectionsList all enterprise connections for a DNSFilter organization.
ReadList InvoicesRetrieves billing invoices for a DNSFilter organization with pagination and sorting support.
ReadList All IP Addresses (All Endpoint)Retrieve all user-associated IP addresses with basic information.
ReadList MAC AddressesList MAC addresses associated with an organization.
ReadList All NetworksRetrieve ALL networks associated with the user with basic information.
ReadList Networks GeoRetrieve networks with geographical information only.
ReadList All MSP NetworksRetrieve ALL networks associated with the MSP user with basic information.
ReadList Network SubnetsRetrieve subnets associated with a specific network.
ReadList All OrganizationsGet all organizations with optional filtering by type, MSP relationships, or name.
ReadList Organizations SettingsGet basic information and settings of the specified organization.
ReadList Organization UsersGet the users for a specified organization.
ReadList PoliciesRetrieve basic information about user-associated policies.
ReadList All PoliciesRetrieve ALL user-associated policies with basic information.
ReadList Policies for ApplicationRetrieve policies information for a specific application.
ReadList Policy IPsList policy IPs in your DNSFilter organization.
ReadList QP MethodsList all QP (Query Protection) methods available in DNSFilter.
ReadList All Scheduled PoliciesRetrieve ALL scheduled policies associated with the current user.
ReadList Traffic Reports QPSGet queries per second (QPS) metrics for DNS traffic over a specified time period.
ReadList Traffic Reports QPS Active AgentsGet queries per second (QPS) statistics for roaming clients over a time period.
ReadList Traffic Reports QPS Active CollectionsRetrieve queries per second (QPS) metrics for active collections over a specified time period.
ReadList Traffic Reports QPS Active OrganizationsRetrieves the total number of queries per second (QPS) over a time period for active organizations.
ReadList Traffic Reports QPS Active UsersGet the total number of queries per second (QPS) in a time period (maximum 20 minutes) for active users.
ReadList Traffic Reports Query LogsGet query raw logs from DNSFilter traffic reports in a specified period of time.
ReadList Traffic Reports Top AgentsGet the top user agents by DNS traffic volume in a specified time period.
ReadList Traffic Reports Top Application CategoriesGet the top application categories domains in a period of time.
ReadList Traffic Reports Top CategoriesGet the top domain categories accessed during a specified time period.
ReadList Traffic Reports Top CollectionsRetrieve the top collections by traffic volume over a specified time period.
ReadList Traffic Reports Top DomainsGet the top requested domains over a specified time period.
ReadList Traffic Reports Top NetworksGet the top networks ranked by DNS traffic volume over a specified time period.
ReadList Traffic Reports Top OrganizationsGets the top organizations by DNS traffic volume over a specified time period.
ReadList Top Organizations by RequestsGet the top organizations ranked by total number of DNS requests over a specified time period.
ReadList Traffic Reports Top UsersGet the top users by DNS query volume over a specified time period.
ReadList Traffic Reports Total Applications StatsGet statistics of number of requests by application in a time period.
ReadList Traffic Reports Total Applications Agents StatsGet statistics of number of requests for roaming clients by application in a period of time.
ReadList Traffic Reports Total Applications Collections StatsGet statistics of number of requests for collections by application over a specified time period.
ReadList Traffic Reports Total Applications Networks StatsGet statistics showing the number of requests for sites by application across networks over a specified time period.
ReadList Traffic Reports Total Applications OrganizationsGet statistics of number of requests for organizations by application in a period of time.
ReadList Traffic Reports Total Applications Users StatsGet statistics of the number of requests for users by application within a specified time period.
ReadList Traffic Reports Total CategoriesGet the total number of requests by category for sites in a period of time.
ReadList Traffic Reports Total Categories for AgentsGet the total number of requests by category for roaming clients (user agents) during a specified time period.
ReadList Traffic Reports Total Categories CollectionsGet the total number of DNS requests by category for collections over a specified time period.
ReadList Total Categories by OrganizationsGet the total number of DNS requests by category for organizations over a specified time period.
ReadList Traffic Reports by Category for UsersGets the total number of DNS requests by category for users in a specified time period.
ReadList Traffic Reports Total Category StatsGet the total number of stats for a category in a period of time.
ReadList Traffic Reports Total Client StatsGets the organization network, users and client stats from traffic reports.
ReadList Traffic Reports Total CollectionsGet the total number of DNS requests by collection for sites over a specified time period.
ReadList Traffic Reports Total Collections AgentsGet the total number of requests by collection for roaming clients over a specified time period.
ReadList Traffic Reports Total Collections OrganizationsGet the total number of DNS requests by collection for organizations over a specified time period.
ReadList Traffic Reports Total Collections UsersGet the total number of DNS requests by collection for users over a specified time period.
ReadList Traffic Reports Total DeploymentsGets the organization deployments information including collections, relays, sync tools, user agents, and users.
ReadList Traffic Reports Total Domain RequestsGet the total number of requests for a domain over a specified time period.
ReadList Traffic Reports Total DomainsGet the total number of requests by domain for sites in a period of time.
ReadList Traffic Reports Total Domains CollectionsRetrieve the total number of DNS requests by domain for collections within a specified time period.
ReadList Total Domains by OrganizationsGet the total number of DNS requests by domain for organizations over a specified time period.
ReadList Traffic Reports Total Domain StatsGet the total number of stats for a domain in a period of time.
ReadList Traffic Reports Total Domains UsersGets the total number of DNS requests by domain for users in a period of time.
ReadList Total Organizations RequestsGet the total number of DNS requests for organizations in a specified time period.
ReadList Traffic Reports Total Organizations StatsRetrieves aggregated DNS traffic statistics across organizations for a specified time period.
ReadList Traffic Reports Total RequestsGet the total number of DNS requests over a specified time period.
ReadList Traffic Reports Total Requests for AgentsGet the total number of requests for roaming clients (user agents) during a specified time period.
ReadList Traffic Reports Total Requests CollectionsGet the total number of requests for collections over a specified time period.
ReadList Traffic Reports Total Requests GeoGets the total number of DNS requests by geographic location for organizations in a specified time period.
ReadList Total Requests OrganizationsGet the total number of DNS requests for organizations in a specified time period.
ReadList Traffic Reports Total Requests UsersGets the total number of requests for users in a period of time.
ReadList Traffic Reports Total Roaming ClientsGets the roaming clients information for the specified organization.
ReadList Traffic Reports Total ThreatsGet the total number of threats detected over a specified time period.
ReadList Traffic Reports Total Threats AgentsGet the total number of threats for roaming clients in a period of time.
ReadList Total Threats by CollectionsRetrieve the total number of threats for collections over a specified time period.
ReadList Total Threats by OrganizationsGet the total number of threats detected for organizations over a specified time period.
ReadList Traffic Reports Total Threats UsersGet the total number of threats for users in a period of time.
ReadList User Agent Bulk Deletes CountsGet user agent bulk delete counts by filtering criteria.
ReadList User Agent Bulk Updates CountsGet user agent bulk delete counts by filters.
ReadList User Agent ReleasesGets a list of latest user agent releases for each unique combination of agent_type, architecture, release_channels, and white label.
ReadList User Agent Releases RelayGet a list of latest relay releases for each unique combination of architecture, release channels, and white label.
ReadList All User AgentsRetrieve ALL user agents with basic information.
ReadList User Agents CountsGet counts of user agents for each status.
ReadList User Agents CSVExport user agents as CSV data for a specific organization.
ReadList User Agent TagsRetrieves all tags used by user agents on a network or organization.
ReadList All UsersGet all users basic information with optional pagination.
ReadLookup Network By IPGet basic network information based on an IP address lookup.
ReadValidate Auth0 JWTValidate a JWT with Auth0.
WriteAdd Allowed ApplicationAdds a single application to the allow list of a policy in DNSFilter. Approval by default
WriteAdd Allowlist Domains to PoliciesBulk add one or more domains to one or more policies' allow lists. Approval by default
WriteAdd Blacklist Category To PolicyAdd a single category to a policy's blocklist. Approval by default
WriteAdd Blacklist Domain To PolicyAdd a single domain to a policy's blocklist. Approval by default
WriteAdd Blocked ApplicationAdds a single application to the block list of a policy in DNSFilter. Approval by default
WriteAdd Blocklist Domains To PoliciesAdd one or more domains to the blocklist of multiple policies at once. Approval by default
WriteAdd Whitelist DomainAdd a single domain to a policy's allowlist. Approval by default
WriteCancel OrganizationSets an organization as 'Canceled' in DNSFilter by its unique ID. Approval by default
WriteCreate API KeysCreates a new API key in DNSFilter for authentication and API access. Approval by default
WriteCreate IP AddressCreates a new IP address entry in DNSFilter for network filtering and policy enforcement. Approval by default
WriteCreate MAC AddressCreates a new MAC address entry in DNSFilter with the specified data. Approval by default
WriteCreate NetworksCreates a new network with the specified configuration in DNSFilter. Approval by default
WriteBulk Create NetworksBulk create multiple networks in DNSFilter with a single API call. Approval by default
WriteCreate Organization UserAdds a new or existing user with the specified email to an organization in DNSFilter. Approval by default
WriteCreate PoliciesCreates a new DNS filtering policy with the specified configuration in DNSFilter. Approval by default
WriteCreate Scheduled PolicyCreates a new scheduled (time-based) policy in DNSFilter. Approval by default
WriteCreate Scheduled Report PreviewsCreates a scheduled report preview for an organization, triggering background generation of the report. Approval by default
WriteCreate Scheduled ReportCreates a scheduled report in DNSFilter to automate regular delivery of network activity and security summaries. Approval by default
WriteCreate User Agent Bulk DeletesCreate a user agent bulk delete operation in DNSFilter. Approval by default
WriteCreate User Agent CleanupCreates a user agent cleanup to track bulk deletion of inactive user agents in DNSFilter. Approval by default
WriteDelete API KeyRemove an API key by its ID. Approval by default
WriteDelete IP AddressRemoves an IP address from DNSFilter by its unique ID. Approval by default
WriteDelete MAC AddressDeletes a MAC address entry from DNSFilter by its ID. Approval by default
WriteDelete Networks (Bulk)Bulk destroy multiple networks in DNSFilter. Approval by default
WriteDelete PoliciesDeletes a DNS filtering policy from DNSFilter by its unique ID. Approval by default
WriteDelete Scheduled PoliciesRemoves a scheduled policy from the DNSFilter database by its unique ID. Approval by default
WriteDelete Scheduled ReportDelete a scheduled report by its ID. Approval by default
WriteRemove Allowed ApplicationRemoves a single application from the allow list of a policy in DNSFilter. Approval by default
WriteRemove Allowlist Domains from PoliciesRemove one or more domains from one or more policies' allow lists. Approval by default
WriteRemove Blacklist CategoryRemove a single category from a policy's blocklist. Approval by default
WriteRemove Blacklist Domain From PolicyRemove a single domain from a policy's blocklist. Approval by default
WriteRemove Blocked ApplicationRemoves a single application from the block list of a policy in DNSFilter. Approval by default
WriteRemove Blocklist DomainsRemove one or more domains from one or more policy block lists in bulk. Approval by default
WriteRemove Whitelist Domain from PolicyRemove a single domain from a policy's whitelist/allowlist. Approval by default
WriteResend User InviteResend an invitation email to a user in a DNSFilter organization. Approval by default
WriteSuggest Domain ThreatSubmit a domain threat report to DNSFilter for review and potential threat categorization. Approval by default
WriteUpdate Billing AddressUpdates the billing address for a DNSFilter organization. Approval by default
WriteUpdate Current UserUpdates profile attributes for the currently authenticated DNSFilter user. Approval by default
WriteUpdate Enterprise ConnectionUpdates an existing enterprise connection for SSO authentication in DNSFilter. Approval by default
WriteUpdate IP AddressUpdates an existing IP address record in DNSFilter with new data. Approval by default
WriteUpdate MAC AddressUpdates an existing MAC address entry in DNSFilter with new configuration. Approval by default
WriteBulk Update NetworksBulk update multiple networks with specified configuration changes. Approval by default
WriteUpdate OrganizationsUpdates an existing organization with the specified data in DNSFilter. Approval by default
WriteUpdate Organization UserUpdates a user or permissions within an organization in DNSFilter. Approval by default
WriteUpdate PoliciesUpdates an existing DNS filtering policy with the specified configuration in DNSFilter. Approval by default
WriteUpdate Policies ApplicationUpdates a policy with the specified application data, configuring which policies allow or block access to an application. Approval by default
WriteUpdate Policy Permissive ModeUpdate the permissive mode setting for a specific policy. Approval by default
WriteUpdate Scheduled PoliciesUpdates an existing scheduled policy in DNSFilter with the specified data. Approval by default
WriteUpdate Scheduled ReportsUpdates an existing scheduled report configuration in DNSFilter. Approval by default
WriteUpdate User Agent CleanupsUpdates a user agent cleanup operation in DNSFilter. Approval by default
One prompt, start to finish
What a governed Dnsfilter run looks like inside Luumen.
Questions
How does LuumenAI connect to Dnsfilter?
Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Can LuumenAI change things in Dnsfilter on its own?
Read actions answer immediately. Anything that writes — add allowed application, add allowlist domains to policies, add blacklist category to policy, add blacklist domain to policy, and more — is shown as a plan and requires approval by default, including the 17 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
Who gets access to the integration?
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Is there an audit trail?
Every call to Dnsfilter — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.