AvantGuard - DNSFilter icon

AvantGuard - DNSFilter

AvantGuard - DNSFilter

Actions277

Overview

This node operation allows bulk deletion of blocked URLs associated with a specific policy in the AvantGuard DNSFilter system. It is useful for administrators who need to efficiently manage and clean up large sets of URL filters that are no longer needed or relevant. For example, if a security policy has accumulated many outdated or incorrect blocked URLs, this operation can remove them all at once based on specified criteria or explicit IDs.

Properties

Name Meaning
Policy Id The unique identifier of the policy to which the blocked URLs belong. This is required to specify the scope of deletion.
Additional Query Parameters Optional filters to narrow down which blocked URLs to delete:
- Search: Text search on fields like value and note.
- Type: Filter by type of block (valid types: url, pattern, domain, tld).
Additional Body Fields Optional additional data sent in the request body:
- Ids: JSON array of specific URL filter IDs to delete, overriding any filters.
- Exclude Ids: JSON array of URL filter IDs to exclude from deletion when using filters.

Output

The node outputs JSON data representing the result of the bulk delete operation. This typically includes confirmation of which blocked URLs were deleted or any errors encountered during the process. There is no binary output involved.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard DNSFilter API.
  • The node sends HTTP requests to the base URL https://api.dnsfilter.com.
  • Proper configuration of the API authentication credential within n8n is necessary.

Troubleshooting

  • Missing or invalid Policy Id: The operation requires a valid policy ID; ensure it is provided and correct.
  • Invalid JSON in Ids or Exclude Ids: When specifying these as JSON arrays, ensure the syntax is correct to avoid parsing errors.
  • API Authentication Errors: If the API key is missing, expired, or incorrect, the node will fail to authenticate.
  • No URLs matched for deletion: If filters are too restrictive or IDs do not exist, no URLs may be deleted; verify filter parameters.
  • Network or API downtime: Connectivity issues or API service interruptions will cause failures; check network and API status.

Links and References

Discussion