---
title: "Delete List"
method: PATCH
path: "/v1/subscriber_list/{list_id}/delete/"
---

# Delete List

`PATCH /v1/subscriber_list/{list_id}/delete/`

API to permanently delete a list.

## Path parameters

- `list_id` string, required

## Response `200`

200

- object — Success message when the list is successfully deleted

## Other responses

- `404` — 404 - Not Found

## Changes

- **2026-08-20** `9a5a2cd152ae` — 1 breaking
  - added the pattern `^[a-z0-9_-]+$` to the `path` request parameter `list_id`

[Change history](https://skmtc.dev/suprsend/apis/suprsend-api/changes/v1/subscriber_list/:list_id/delete/patch.md)

---

[API](https://skmtc.dev/suprsend/apis/suprsend-api.md) · [All operations](https://skmtc.dev/suprsend/apis/suprsend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/suprsend/suprsend-api/revisions/ea7b2f7c41a9/schema)