---
title: "Delete a list"
method: DELETE
path: "/api/v2/lists/{id}"
tags: ["Lists"]
---

# Delete a list

`DELETE /api/v2/lists/{id}`

<a class="try-sandbox-link" href="https://sandbox.textmagic.com/#/Lists/deleteList" target="_blank">Try in sandbox</a><br>This command has no parameters. If successful, this command will return the standard delete response (204 No Content); otherwise, a standard error response will be returned.

When you delete a list, the contacts in it are deleted as well, unless they were saved in another list.

## Path parameters

- `id` integer, required

## Response `204`

Request executed with success.

## Other responses

- `400` — Returned when trying to remove a list associated with a signup form.
- `401` — Unauthorized request.
- `403` — Returned when trying to remove a list shared to you.
- `404` — Request data not found.

---

[API](https://skmtc.net/textmagic/apis/textmagic-api.md) · [All operations](https://skmtc.net/textmagic/apis/textmagic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/textmagic/textmagic-api/revisions/3e4029d19684/schema)