Skip to main content
DELETE
Delete Lead List
Permanently deletes a lead list by its unique identifier. This action cannot be undone.

Authentication

This endpoint requires authentication. Only users with access to the lead list (or admin users) can delete it.
This operation is irreversible. The lead list and its associations will be permanently removed. The underlying persons or companies are not deleted.

Request

string (UUID)
required
The unique identifier of the lead list to delete.

Response

Returns an empty response with status code 204 No Content on successful deletion.
void
No response body is returned on successful deletion.

Response Examples

Error Codes

Authorization Rules

  • Access Control: Only users whose ID is in the userIds array can delete the lead list.
  • Admin Override: Users with the admin role can delete any lead list regardless of userIds.

Notes

  • Deleting a lead list does not delete the associated persons or companies. Only the list itself and its ID associations are removed.
  • If you need to archive a list instead of permanently deleting it, consider implementing a soft-delete mechanism or moving the list to an archive state.