---
title: "Delete a checklist"
method: DELETE
path: "/api/v1/checklists/{id}"
tags: ["Checklists"]
---

# Delete a checklist

`DELETE /api/v1/checklists/{id}`

## Request

- Base URL: `https://api.checkcherry.com`
- URL: `https://api.checkcherry.com/api/v1/checklists/{id}`
- Auth: none declared. Required headers: `Api-Key`

Permanently removes a checklist and all of its items. The deletion is logged on the attached event's change history when applicable.

**Required permission:** `assigned_event_write` (when the authenticated user is assigned to the checklist's event) or `unassigned_event_write` (otherwise). Staff users without admin role also need the per-checklist `allow_staff_edit` flag. Customers cannot delete checklists. User-checklists (personal task lists) cannot be deleted via the API — they are singletons that recreate themselves on next access.

## Path parameters

- `id` integer, required

## Headers

- `Api-Key` string, required

## Response `200`

checklist deleted

---

[API](https://skmtc.dev/checkcherry/apis/check-cherry-business-api.md) · [All operations](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/revisions/84a9aabdf519?raw)