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

# Delete List

> Delete a contact list

Delete a contact list and all its contacts.

<Warning>
  This action is irreversible. All contacts in the list will be permanently deleted.
</Warning>

## Path Parameters

<ParamField path="id" type="string" required>
  The unique list ID (e.g., `lst_abc123`).
</ParamField>

## Examples

<CodeGroup>
  ```typescript JavaScript theme={null}
  import { MailBreeze } from "mailbreeze";

  const mailbreeze = new MailBreeze({ apiKey: "sk_live_xxx" });

  await mailbreeze.lists.delete("lst_abc123");

  console.log("List deleted");
  ```

  ```python Python theme={null}
  from mailbreeze import MailBreeze

  client = MailBreeze(api_key="sk_live_xxx")

  await client.lists.delete("lst_abc123")

  print("List deleted")
  ```

  ```go Go theme={null}
  client := mailbreeze.NewClient("sk_live_xxx")

  err := client.Lists.Delete(ctx, "lst_abc123")
  if err != nil {
      log.Fatal(err)
  }

  fmt.Println("List deleted")
  ```

  ```php PHP theme={null}
  $mailbreeze = new MailBreeze('sk_live_xxx');

  $mailbreeze->lists->delete('lst_abc123');

  echo "List deleted";
  ```

  ```rust Rust theme={null}
  let client = Client::new("sk_live_xxx");

  client.lists().delete("lst_abc123").await?;

  println!("List deleted");
  ```

  ```bash cURL theme={null}
  curl -X DELETE "https://api.mailbreeze.com/api/v1/contact-lists/lst_abc123" \
    -H "Authorization: Bearer sk_live_xxx"
  ```
</CodeGroup>

## Response

Returns `204 No Content` on success with no response body.

## Errors

| Code          | HTTP Status | Description                            |
| ------------- | ----------- | -------------------------------------- |
| `NOT_FOUND`   | 404         | List with this ID doesn't exist        |
| `LIST_IN_USE` | 409         | List is being used by active campaigns |

<Note>
  If you need to preserve contacts, export them before deleting the list, or move them to another list using the contacts update endpoint.
</Note>