delete_lead_list
Destructive
Permanently delete a lead list from Instantly.ai after user confirmation. This action removes the list and may orphan leads, and cannot be reversed.
Instructions
🚨 PERMANENTLY delete a lead list. CANNOT UNDO!
⚠️ REQUIRES USER CONFIRMATION before executing!
This action:
Permanently removes the lead list
Leads in the list may be orphaned (check your workflow)
Cannot be reversed
Before calling this tool, you MUST:
Confirm with the user that they want to delete this list
Verify the list_id is correct
Warn them this action cannot be undone
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/instantly_mcp/tools/leads.py:423-447 (handler)The main handler function for the delete_lead_list tool. It performs a permanent deletion of the specified lead list via the API client and returns a success message.
async def delete_lead_list(params: DeleteLeadListInput) -> str: """ 🚨 PERMANENTLY delete a lead list. CANNOT UNDO! ⚠️ REQUIRES USER CONFIRMATION before executing! This action: - Permanently removes the lead list - Leads in the list may be orphaned (check your workflow) - Cannot be reversed Before calling this tool, you MUST: 1. Confirm with the user that they want to delete this list 2. Verify the list_id is correct 3. Warn them this action cannot be undone """ client = get_client() result = await client.delete(f"/lead-lists/{params.list_id}") return json.dumps({ "success": True, "deleted_list_id": params.list_id, "message": "Lead list permanently deleted", **result }, indent=2) - Pydantic input model for the delete_lead_list tool, defining the required list_id parameter.
class DeleteLeadListInput(BaseModel): """ Input for deleting a lead list. ⚠️ PERMANENT - CANNOT UNDO! Requires user confirmation before executing. """ model_config = ConfigDict(str_strip_whitespace=True, extra="ignore") list_id: str = Field(..., description="Lead List UUID to DELETE PERMANENTLY") - src/instantly_mcp/server.py:97-97 (registration)MCP tool annotation registration in server.py, marking delete_lead_list as destructive and requiring confirmation.
"delete_lead_list": {"destructiveHint": True, "confirmationRequiredHint": True}, - src/instantly_mcp/tools/leads.py:450-463 (registration)Local registration of delete_lead_list in the LEAD_TOOLS list, used by the server to collect and register tools.
LEAD_TOOLS = [ list_leads, get_lead, create_lead, update_lead, list_lead_lists, create_lead_list, update_lead_list, get_verification_stats_for_lead_list, add_leads_to_campaign_or_list_bulk, delete_lead, delete_lead_list, move_leads_to_campaign_or_list, ]