# DELETE /lists/{id}

Part of the SendHeron REST API. Base URL: `https://api.sendheron.com/api/v1`

Delete a list.

```http
DELETE https://api.sendheron.com/api/v1/lists/{id}
Authorization: Bearer <YOUR_API_KEY>
```

**Required scopes:** `contacts:write`

**Success status:** `200`

**Rate limit:** 100/min per key, counted against the organization's WRITE ceiling (400/min).

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | uuid | yes | List UUID. |

> Removes the list and its memberships; the contacts stay. A sequence whose `LIST_ADDED` trigger names the list is not edited and never fires again, and a bulk send that names the list is refused. The response is `{ deleted: true }`.


---

Rate limits: 100/min per key, counted against the organization's WRITE ceiling (400/min). Both windows are one minute.
