DNSFilter User Agent Bulk Deletes API
The User Agent Bulk Deletes API from DNSFilter — 3 operation(s) for user agent bulk deletes.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/dnsfilter-user-agent-bulk-deletes-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: DNSFilter User Agent Bulk Deletes API
description: '**Note:** If you are a distributor integrating with DNSFilter, please check
out our Distributors Development Guide.'
version: '2026-07-13'
servers:
- url: https://api.dnsfilter.com
description: Production
tags:
- name: User Agent Bulk Deletes
description: ''
paths:
/v1/user_agent_bulk_deletes:
post:
tags:
- User Agent Bulk Deletes
operationId: V1_User_Agent_Bulk_Deletes-create
parameters:
- name: agent_state
description: filter by agent state
required: false
in: query
schema:
type: string
enum:
- protected
- unprotected
- bypassed
- uninstalled
- name: agent_version
description: Filter user agents by agent version.
required: false
in: query
schema:
type: string
- name: block_page_id
description: Filter user agents by block page ID
required: false
in: query
schema:
type: integer
- name: name_search
description: A search term to search client name fields (i.e. hostname and friendly_name)
required: false
in: query
schema:
type: string
- name: network_ids
description: Networks IDs, defaults to all
required: false
in: query
schema:
type: array
items:
type: integer
explode: true
- name: organization_id
description: Organization ID
required: false
in: query
schema:
type: integer
- name: organization_ids
description: Organization IDs
required: false
in: query
schema:
type: array
items:
type: integer
explode: true
- name: policy_id
description: Filter user agents by policy ID
required: false
in: query
schema:
type: integer
- name: policy_schedule
description: Filter user agents by policy/schedule name
required: false
in: query
schema:
type: string
- name: queue_uninstall
description: either soft delete or uninstall based on this value
required: false
in: query
schema:
type: boolean
- name: release_channels
description: 'Filter user agents by release channel. Valid values: stable, beta, preview'
required: false
in: query
schema:
type: object
properties:
value:
type: string
- name: scheduled_policy_id
description: Filter user agents by scheduled_policy ID
required: false
in: query
schema:
type: integer
- name: search
description: 'User agent list by keyword(s) (space delimited), this could be: hostname, friendly name'
required: false
in: query
schema:
type: string
- name: state
description: filter by user agent online/offline state
required: false
in: query
schema:
type: string
enum:
- online
- offline
- name: status
description: 'filter by user agent status, valid attributes: active, disabled, uninstalled'
required: false
in: query
schema:
type: string
- name: tags
description: User agent list by tags
required: false
in: query
schema:
type: array
items:
type: string
explode: true
- name: traffic_received_last_15_mins
description: filter by agents that have received traffic in last 15 minutes
required: false
in: query
schema:
type: boolean
- name: type
description: User agent type, defaults to non-proxy/no-relays user agents
required: false
in: query
schema:
type: string
enum:
- proxy
- agents
responses:
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'200':
description: User agent bulk delete
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/UserAgentBulkDelete'
description: Create a user agent bulk delete.
summary: Create
security:
- header_authorization: []
x-controller: v1/user_agent_bulk_deletes
x-action: create
requestBody:
description: User agent bulk delete information, ids overrides filters, exclude_ids removes agents from filtered set
content:
application/json:
schema:
$ref: '#/components/schemas/UserAgentBulkDeleteCreate'
/v1/user_agent_bulk_deletes/{id}:
get:
tags:
- User Agent Bulk Deletes
operationId: V1_User_Agent_Bulk_Deletes-show
parameters:
- name: id
description: Id of user agent bulk delete
required: true
in: path
schema:
type: integer
responses:
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'200':
description: User agent bulk delete
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/UserAgentBulkDelete'
description: Gets a user agent bulk delete by id.
summary: Show
security:
- header_authorization: []
x-controller: v1/user_agent_bulk_deletes
x-action: show
/v1/user_agent_bulk_deletes/counts:
get:
tags:
- User Agent Bulk Deletes
operationId: V1_User_Agent_Bulk_Deletes-counts
parameters:
- name: agent_state
description: filter by agent state
required: false
in: query
schema:
type: string
enum:
- protected
- unprotected
- bypassed
- uninstalled
- name: name_search
description: A search term to search client name fields (i.e. hostname and friendly_name)
required: false
in: query
schema:
type: string
- name: network_ids
description: Networks IDs, defaults to all
required: false
in: query
schema:
type: array
items:
type: integer
explode: true
- name: organization_id
description: Organization ID
required: false
in: query
schema:
type: integer
- name: search
description: 'User agent list by keyword(s) (space delimited), this could be: hostname, friendly name'
required: false
in: query
schema:
type: string
- name: state
description: filter by user agent online/offline state
required: false
in: query
schema:
type: string
enum:
- online
- offline
- name: status
description: 'filter by user agent status, valid attributes: active, disabled, uninstalled'
required: false
in: query
schema:
type: string
- name: tags
description: User agent list by tags
required: false
in: query
schema:
type: array
items:
type: string
explode: true
- name: traffic_received_last_15_mins
description: filter by agents that have received traffic in last 15 minutes
required: false
in: query
schema:
type: boolean
- name: type
description: User agent type, defaults to non-proxy/no-relays user agents
required: false
in: query
schema:
type: string
enum:
- proxy
- agents
responses:
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'200':
description: User agent counts information
content:
application/json:
schema:
$ref: '#/components/schemas/UserAgentBulkDeleteCounts'
description: Gets a user agent bulk delete counts by id.
summary: Counts
security:
- header_authorization: []
x-controller: v1/user_agent_bulk_deletes
x-action: counts
components:
schemas:
UserAgentBulkDeleteCreate:
type: object
properties:
ids:
type: array
items:
type: string
description: Ids of user agents to delete. Overrides any lookups based on filters
exclude_ids:
type: array
items:
type: string
description: Ids of user agents to remove from delete when using filters
description: User agent bulk delete
UserAgentBulkDelete:
type: object
properties:
organization_id:
type: integer
description: Organization resource ID
completed:
type: boolean
description: true if bulk delete is completed
count:
type: integer
description: count of affected user agents
queue_uninstall:
type: boolean
description: true if action was bulk delete and uninstall
description: User agent bulk delete
Error:
type: object
properties:
error:
type: string
description: 'Error message (e.x.: Not Authorized)'
description: Error basic representation
UserAgentBulkDeleteCounts:
type: object
properties:
uninstall_and_delete:
type: integer
description: the count of user agents that can bed uninstalled and deleted
delete:
type: integer
description: the count of unsupported user agents that can be deleted
description: User agent counts by remote uninstall support
securitySchemes:
header_authorization:
type: apiKey
name: Authorization
in: header