# delete_filter (/docs/mcp/tools/delete-filter)

{/* Generated by scripts/sync-mcp-tools.mjs from happierleads-api. Do not edit: change src/routes/mcp/toolDocs.json there, or add content/mcp-notes/delete_filter.mdx. */}

**Delete a saved filter** · Deletes or overwrites data

Delete a saved lead filter. Any automation that used it as its segment is switched to 'All leads', so it will then run for every new lead; check list_automations before deleting a filter an automation depends on. filterId is the _id from list_filters. Confirm with the user before calling. Returns status 'successful', or an error when the filter does not exist.

| Connection | Account URL, team member URL or OAuth |
| --- | --- |

## Parameters [#parameters]

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `filterId` | `string` | Yes | Saved filter id (the _id from list_filters). |

## Tool definition [#tool-definition]

What your assistant receives from `tools/list`:

```json
{
  "name": "delete_filter",
  "title": "Delete a saved filter",
  "annotations": {
    "title": "Delete a saved filter",
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "filterId": {
        "type": "string",
        "description": "Saved filter id (the _id from list_filters)."
      }
    },
    "required": [
      "filterId"
    ]
  }
}
```