delete_contacts_by_query
Delete contacts in bulk by matching an advanced query or keyword list, with optional preflight checks to verify editability before removal.
Instructions
Bulk-delete contacts matching an advanced query or keyword list.
Requires bulk delete permission for the authenticated user.
Args: query_json: JSON-encoded advanced search query. If provided, record_type is ignored by Nimble. keyword: Comma-separated list of keywords; contacts whose fields contain any of these values will be deleted. record_type: 'person', 'company', or 'all'. preflight_checks: If true, verify contacts are editable first.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "delete_contacts_by_query"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | No | ||
| query_json | No | ||
| record_type | No | all | |
| preflight_checks | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |