> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Lead List

> Deletes a lead list permanently. Requires authentication.

## Overview

Permanently deletes a lead list and all associated data. This action cannot be undone.

## Path Parameters

| Parameter      | Type   | Required | Description             | Example             |
| -------------- | ------ | -------- | ----------------------- | ------------------- |
| `lead_list_id` | string | Yes      | Lead list ID (lead\_id) | `Lecb6be7be43b4724` |

## Response

Returns a `204 No Content` status on successful deletion.

## Examples

### Delete Lead List

```bash theme={null}
curl -X DELETE "https://management.scanova.io/lead/Lecb6be7be43b4724/" \
  -H "Authorization: YOUR_API_KEY"
```

## Important Considerations

### Before Deleting

* **Check Linked QR Codes**: Ensure no active QR codes are using this lead list
* **Backup Data**: Export any important lead data before deletion
* **Notify Team**: Inform team members about the deletion
* **Consider Deactivation**: Use the update endpoint to deactivate instead of delete

### What Gets Deleted

* Lead list configuration
* All captured lead entries
* Webhook configurations
* Form settings and styling

### What Remains

* QR codes that were linked to this lead list (they will have no lead list attached)
* Historical analytics data (if any)

## Use Cases

* **Cleanup**: Remove unused or test lead lists
* **Data Privacy**: Delete lead lists containing sensitive information
* **Account Management**: Clean up old lead lists to stay within limits
* **Compliance**: Remove lead lists for GDPR or other compliance requirements

<Warning>
  **Permanent Action**: Deleting a lead list is irreversible. All lead data and configurations will be permanently lost. Consider deactivating the lead list instead if you might need it later.
</Warning>

<Note>
  If you need to preserve the lead data, consider exporting it first or simply deactivating the lead list using the update endpoint.
</Note>


## OpenAPI

````yaml DELETE /lead/{lead_list_id}/
openapi: 3.1.0
info:
  title: Scanova Lead List API
  description: >-
    Lead list management endpoints for creating, updating, and managing lead
    lists
  version: 1.0.0
servers:
  - url: https://management.scanova.io
    description: Production server
security:
  - apiKeyAuth: []
tags:
  - name: Lead List
    description: Lead list management operations
paths:
  /lead/{lead_list_id}/:
    delete:
      tags:
        - Lead List
      summary: Delete Lead List
      description: Deletes a lead list permanently. Requires authentication.
      parameters:
        - name: lead_list_id
          in: path
          required: true
          description: Lead list ID (lead_id)
          schema:
            type: string
          example: Lecb6be7be43b4724
      responses:
        '204':
          description: Lead list deleted successfully
        '401':
          description: Unauthorized - Invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthenticationErrorResponse'
        '404':
          description: Lead list not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - apiKeyAuth: []
components:
  schemas:
    AuthenticationErrorResponse:
      type: object
      properties:
        detail:
          type: string
          description: Authentication error message
          example: Invalid token.
    ErrorResponse:
      type: object
      properties:
        detail:
          type: string
          description: Error message
          example: Not found.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        API key authentication. Enter your API key directly in the Authorization
        header.

````