# DNSFilter integration {% hint style="info" %} If you’re new to integrations in Rewst, read through our introductory integration documentation [here](https://docs.rewst.help/documentation/integrations). {% endhint %} ## What does the DNSFilter integration do? Our DNSFilter integration enables the automation of DNS-based content filtering and web security tasks. ## Set up the DNSFilter integration ### Set up steps with DNSFilter Please contact DNSFilter support and request for a JWT/API token. ### Set up steps in Rewst 1. Navigate to **Marketplace > Integrations** in the left side menu of your Rewst platform. 2. Search for `DNSFilter` in the integrations page.\ \ ![A visual card for "DNSFilter" integration with Rewst, showing the DNSFilter logo. The description states: “Enables automation of DNS-based content filtering and web security tasks. Utilize DNSFilter APIs within Rewst workflows to allow help desk teams to apply policy exceptions and complete user onboarding and offboarding, without needing login access to DNSFilter. Rewst workflows can manage DNSFilter users, networks, policies, and more.” The card is marked as last updated on May 1st, 2025, and includes two category tags: "DNS" and "Security" at the bottom. This is how the integration's search result appears in Rewst's integrations collection.](https://1835401289-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQQ1EHVcEsGKBPVHmiav%2Fuploads%2FLXIUxAj8w2l9HG19lsOl%2FScreenshot%202025-05-01%20at%204.09.22%E2%80%AFPM.png?alt=media\&token=9ea6ce91-321e-496d-927e-6fc9d544d50d) 3. Click on the integration tile to launch the configuration setup page. 4. Enter the value given to you by DNSFilter into the **API Token** field. 5. Click **Save Configuration**. 6. Rewst will do a quick validation of your input. Once completed, you'll see a new section beneath the configuration form for[ organization mapping](https://docs.rewst.help/documentation/integrations#what-is-organization-mapping). Complete your mapping as desired. {% hint style="success" %} Got an idea for a new Integration? Rewst is constantly adding new integrations to our integrations page. Submit your idea or upvote existing ideas here in our [Canny feedback collector](https://rewst.canny.io/integrations). {% endhint %} ## Actions and endpoints {% hint style="info" %} For more on how actions work in Rewst, check out our [introductory actions documentation here](https://docs.rewst.help/documentation/workflows/actions-in-rewst). {% endhint %} | Category | Action | Description | | ---------------------- | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | **Agent Local User** | List Agent Local Users | Gets the agent local users associated to an organization with basic information | | **Agent Local User** | List All Agent Local Users | Gets ALL agent local users associated to an user organization with basic information | | **Agent Local User** | Get Agent Local User | Gets basic information of the specified agent local user | | **Agent Local User** | Update Agent Local User | Updates an agent local user with the specified data | | **Billings** | List User Organization Billing | List basic billing information of the user organization registered in Stripe platform | | **Billings** | Create Payment Method | Register a newly created payment method in database | | **Block Pages** | List Block Pages | Gets the list of block pages associated with the current user | | **Block Pages** | Create Block Page | Creates a new block page | | **Block Pages** | List All Block Pages | Gets ALL block pages associated with the current user | | **Block Pages** | Get Block Page | Gets the specified block page | | **Block Pages** | Update Block Page | Updates a block\_page in the database with the specified data | | **Block Pages** | Delete Block Page | Removes a block page from the database | | **Categories** | List Categories | List categories basic information | | **Categories** | List All Categories | List all categories including internal categories | | **Categories** | Get Category | Gets basic information of a specific category | | **Collection Users** | Create Collection User With Filter And Sort | Add a new user to a specific collection with the specified id | | **Collection Users** | Create Collection User | Add a new user to a specific collection with the specified id | | **Collection Users** | Get User Permissions | Gets the user details and permissions for the specified organization | | **Collection Users** | Delete User From Collection | Deletes a user from a collection | | **Collections** | List Agent Local Users With Class Type | Gets the agent local users associated to a collection or group | | **Collections** | List Agent Local Users In Organization | Gets the agent local users associated to a collection or group | | **Domains** | List Domains By FQDN | Gets all the domains associated for a particular FQDN | | **Domains** | List Domains And Categories For FQDNs | Gets the domains and categories associated for each FQDN of the specified list | | **Domains** | Mark FQDN For Categorization Verification | Mark a FQDN to verify its categorization with suggested ones | | **Domains** | Update FQDN Threat Categorization | Mark a FQDN to verify its threat categorization | | **Generic Request** | DNS API Request | Generic action for making authenticated requests against the DNSFilter API | | **Invoices** | Get User Estimated Invoice For Next Month | Gets user estimated invoice for next month. WARNING: almost all invoice data are `null` values, take that into consideration when using this endpoint | | **Invoices** | List User Invoices | Gets user associated invoices, most recent first | | **Invoices** | Get Invoice | Gets basic information of the specified invoice | | **Ip Addresses** | Get User IP Addresses | Gets user associated IP addresses basic information | | **Ip Addresses** | Create IP Address | Creates a new IP address with the specified data | | **Ip Addresses** | List User IP Addresses | Gets ALL user associated IP addresses basic information | | **Ip Addresses** | Get IP Address | Gets basic information of the specified IP address | | **Ip Addresses** | Update IP Address | Updates an IP address with the specified data | | **Ip Addresses** | Delete IP Address | Removes an IP address | | **Ip Addresses** | Verify IP Address | Verification call to ensure IP address is not already in the system | | **Ip Addresses** | Get Requester IP Address | Responds with the requester reported IP address | | **Mac Addresses** | List MAC Addresses | Gets the MAC addresses associated to an organization with basic information | | **Mac Addresses** | Create MAC Address | Creates a new MAC address with the specified data | | **Mac Addresses** | List User MAC Addresses | Gets ALL MAC addresses associated to an user with basic information | | **Mac Addresses** | Get MAC Address Info | Gets basic information of the specified MAC address | | **Mac Addresses** | Update MAC Address | Updates a MAC address with the specified data | | **Mac Addresses** | Delete MAC Address | Removes a MAC address | | **Network Lan Ips** | List Network Lan IPs | Gets network associated LAN IPs with basic information | | **Network Lan Ips** | Get Network Lan IP | Gets network associated LAN IP with basic information | | **Network Lan Ips** | Update Network Lan IP | Updates a network LAN IP in the database with the specified data | | **Network Subnets** | List Site Subnets | List site subnets with basic information | | **Network Subnets** | List Network Subnets | Gets network associated subnets with basic information | | **Network Subnets** | Create Network Subnet | Creates a network subnet in the database with the specified data | | **Network Subnets** | Get Network Subnet | Gets network associated subnet with basic information | | **Network Subnets** | Update Network Subnet | Updates a network subnet in the database with the specified data | | **Network Subnets** | Delete Network Subnet | Deletes a network subnet in the database with the specified data | | **Networks** | List User Associated Networks | Gets users associated networks with basic information | | **Networks** | Create Network | Creates a new network with the specified data | | **Networks** | List User Networks | Gets ALL networks associated to the user with its basic information | | **Networks** | List Msp User Networks | Gets MSP user associated networks with basic information | | **Networks** | List All Msp User Networks | Gets ALL networks associated to the MSP user with its basic information | | **Networks** | Get Network Info By IP Addresses | Gets basic information of a network based on its associated IP addresses | | **Networks** | Get Network | Gets basic information of the specified network | | **Networks** | Update Network | Updates a network with the specified data | | **Networks** | Delete Network | Deletes a network | | **Networks** | Create Network Secret Key | Creates a new network secret key to be used by agents | | **Networks** | Delete Network Secret Key | Revokes a network secret key | | **Networks** | Update Network Secret Key | Rotates (renew) a network secret key to be used by agents | | **Organization Users** | List Organization Users | Gets the users for the specified organization | | **Organization Users** | Get Organization User | Gets the user details and permissions for the specified organization | | **Organization Users** | Update User Or Permissions | Updates a user or permissions with the specified data | | **Organization Users** | Delete Organization User | Removes a user from the organization. This will not actually delete the user account. | | **Organization Users** | Create Organization User | Adds a new or existing user with the specified email to the specified organization. | | **Organizations** | List User Organizations | Gets users associated organizations basic information | | **Organizations** | Create Organization | Creates a new organization with the specified data | | **Organizations** | List Organizations Basic | Gets all organizations basic information | | **Organizations** | Get Organization Information | Gets basic information of the specified organization | | **Organizations** | Update Organization | Updates an organization with the specified data | | **Organizations** | Delete Msp Customer | Deletes an MSP customer | | **Organizations** | Update Organization Status To Canceled | Sets an organization as 'Canceled' | | **Organizations** | Promote Organization To Msp | Promote an organization to a MSP | | **Policies** | Get User Associated Policies | Gets user associated policies basic information from database | | **Policies** | Create Policy | Creates a new policy with the specified data | | **Policies** | List User Policies | Gets ALL user associated policies basic information from database | | **Policies** | Get Policy | Gets basic information of the specified policy | | **Policies** | Update Policy | Updates a policy with the specified data | | **Policies** | Delete Policy | Deletes a policy | | **Policies** | Add Blacklist Domain to Policy | Adds a domain to the blacklist of the specified policy | | **Policies** | Remove Domain from Blacklist of Policy | Removes a domain from the blacklist of the specified policy | | **Policies** | Add Whitelist Domain to Policy | Adds a domain to the whitelist of the specified policy | | **Policies** | Remove Domain from Whitelist of Policy | Removes a domain from the whitelist of the specified policy | | **Policies** | Add Blacklist Category to Policy | Adds a category to the blacklist of the specified policy | | **Policies** | Remove Category from Blacklist of Policy | Removes a category from the blacklist of the specified policy | | **Policies** | Add Allowed Application to Policy | Adds an application to the allowed list of the specified policy | | **Policies** | Remove Allowed Application from Policy | Removes an application from the allowed list of the specified policy | | **Policies** | Add Blocked Application to Policy | Adds an application to the blocked list of the specified policy | | **Policies** | Remove Blocked Application from Policy | Removes an application from the blocked list of the specified policy | | **Policy Ips** | Get User Policies Ips | Gets user associated policies IPs basic information from database | | **Policy Ips** | Get Policy IP | Gets basic information of the specified Policy IP | | **Scheduled Policies** | List Scheduled Policies | Gets the list of scheduled policies associated with the current user | | **Scheduled Policies** | Create Scheduled Policy | Creates a new scheduled policy | | **Scheduled Policies** | List All Scheduled Policies | Gets ALL scheduled policies associated with the current user | | **Scheduled Policies** | Get Scheduled Policy | Gets the specified scheduled policy | | **Scheduled Policies** | Update Scheduled Policy | Updates a scheduled policy in the database with the specified data | | **Scheduled Policies** | Delete Scheduled Policy | Removes a scheduled policy from the database | | **Traffic Reports** | Get Total Requests | Gets the total number of requests for sites in a period of time | | **Traffic Reports** | Get Total Requests For Organizations In Time Period | Gets the total number of requests for organizations in a period of time | | **Traffic Reports** | Get Total Requests For Roaming Clients | Gets the total number of requests for roaming clients in a period of time | | **Traffic Reports** | Get Total Requests For Users | Gets the total number of requests for users in a period of time | | **Traffic Reports** | Get Total Requests For Collections | Gets the total number of requests for collections in a period of time | | **Traffic Reports** | Get Total Threats For Sites In Time Period | Gets the total number of threats for sites in a period of time | | **Traffic Reports** | Get Total Threats For Organizations | Gets the total number of threats for organizations in a period of time | | **Traffic Reports** | Get Total Threats For Roaming Clients | Gets the total number of threats for roaming clients in a period of time | | **Traffic Reports** | Get Total Threats For Users In Time Period | Gets the total number of threats for users in a period of time | | **Traffic Reports** | List Total Threats For Collections | Gets the total number of threats for collections in a period of time | | **Traffic Reports** | List Total Requests By Category | Gets the total number of requests by category for sites in a period of time | | **Traffic Reports** | List Total Requests By Category For Organizations | Gets the total number of requests by category for organizations in a period of time | | **Traffic Reports** | List Requests By Category For Roaming Clients | Gets the total number of requests by category for roaming clients in a period of time | | **Traffic Reports** | List Requests By Category | Gets the total number of requests by category for users in a period of time | | **Traffic Reports** | List Requests By Category For Collections | Gets the total number of requests by category for collections in a period of time | | **Traffic Reports** | Get Total Requests By Domain | Gets the total number of requests by domain for sites in a period of time | | **Traffic Reports** | Get Total Requests By Domain For Organizations | Gets the total number of requests by domain for organizations in a period of time | | **Traffic Reports** | Get Total Requests By Domain For Roaming Clients | Gets the total number of requests by domain for roaming clients in a period of time | | **Traffic Reports** | List Domain Requests | Gets the total number of requests by domain for users in a period of time | | **Traffic Reports** | List Total Requests By Domain For Collections | Gets the total number of requests by domain for collections in a period of time | | **Traffic Reports** | Get Total Requests By Collection | Gets the total number of requests by collection for sites in a period of time | | **Traffic Reports** | Get Total Requests By Collection For Organizations | Gets the total number of requests by collection for organizations in a period of time | | **Traffic Reports** | List Total Requests By Collection For Roaming Clients In Time Period | Gets the total number of requests by collection for roaming clients in a period of time | | **Traffic Reports** | Gets The Total Number Of Requests By Collection For Users In A Period Of Time | Gets the total number of requests by collection for users in a period of time | | **Traffic Reports** | List Qps For Sites | Gets the total number of queries per second in a period of time for sites | | **Traffic Reports** | Get Total Qps For Organizations | Gets the total number of queries per second in a period of time (maximum 20 minutes) for organizations | | **Traffic Reports** | Get Roaming Clients Qps | Gets the total number of queries per second in a period of time (maximum 20 minutes) for roaming clients | | **Traffic Reports** | Get Qps For Users | Gets the total number of queries per second in a period of time (maximum 20 minutes) for users | | **Traffic Reports** | Get Total Qps For Collections | Gets the total number of queries per second in a period of time (maximum 20 minutes) for collections | | **Traffic Reports** | Gets The Top Requested Domains In A Period Of Time | Gets the top requested domains in a period of time | | **Traffic Reports** | List Top Categories Domains | Gets the top categories domains in a period of time | | **Traffic Reports** | List Top Organizations | Gets the top organizations in a period of time | | **Traffic Reports** | List Top Networks | Gets the top networks in a period of time | | **Traffic Reports** | List Top Agents | Gets the top agents in a period of time | | **Traffic Reports** | List Top Users | Gets the top users in a period of time | | **Traffic Reports** | List Top Collections | Gets the top collections in a period of time | | **Traffic Reports** | List Query Raw Logs | Gets the query raw logs in a period of time - *NOTE: maximum time range is 72 hours* \| | | **User Agents** | List User Agents | Gets a list of user agents with basic information | | **User Agents** | List All User Agents | Gets a list of ALL user agents with basic information | | **User Agents** | Get User Agent | Gets the specified user agent with basic information | | **User Agents** | Update User Agent | Updates an user agent with the specified data | | **User Agents** | Delete User Agent | Soft deletes an user agent | | **User Agents** | List User Agent Tags | Gets ALL tags used by user agents on a network or organization | | **Users** | List Users Basic Information | Gets users basic information | | **Users** | List All Users Basic Information | Gets ALL users basic information | | **Users** | Get Information of User | Gets basic information of the specified user | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.rewst.help/documentation/integrations/integration-guides/dns-filter-integration-setup.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.