---
title: "Reset a checklist"
method: PUT
path: "/api/v1/checklists/{id}/reset"
tags: ["Checklists"]
---

# Reset a checklist

`PUT /api/v1/checklists/{id}/reset`

## Request

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

Resets the checklist back to its starting state. All existing items are deleted — any notes, due dates, or staff assignments on those items are lost. If the checklist was seeded from a checklist category, items are repopulated from the category template and the checklist's name plus view/edit flags are restored to the category defaults. If no category is associated, the result is an empty checklist. The reset 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 reset checklists. User-checklists (personal task lists) can only be reset by their owner.

## Path parameters

- `id` integer, required

## Headers

- `Api-Key` string, required

## Response `200`

checklist reset

---

[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)