Delete Lead List

Permanently deletes one lead list owned by the authenticated user.

Deleting a lead list also deletes companies attached to that list. Leads under those companies are deleted by the database cascade through leads.company_id.

• id (integer) (required) — The lead list ID.

curl -X DELETE https://api.hermes.camie.ai/v1/lead-lists/15 \
  -H "Authorization: Bearer hermes_your_api_key"

Response

{
  "success": true,
  "data": {
    "lead_list_id": 15,
    "deleted_companies": 137,
    "deleted_leads": 41,
    "message": "Lead list deleted successfully"
  }
}

Errors

Notes

• This action is destructive. Use GET /v1/lead-lists/:id/companies or GET /v1/lead-lists/:id/leads first if you need to inspect what will be removed.
• The delete response counts companies directly attached to the list and visible lead rows for the authenticated user.