From a82bc7ef62656bd9dc8025d102ee3c3a3d7ba1e1 Mon Sep 17 00:00:00 2001
From: Aleks Volochnev <a.volochnev@gmail.com>
Date: Fri, 9 Oct 2026 14:16:52 +0200
Subject: [PATCH 1/2] Add an API cookbook with curl recipes

---
 docs/api-cookbook.md | 59 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)
 create mode 100644 docs/api-cookbook.md

diff --git a/docs/api-cookbook.md b/docs/api-cookbook.md
new file mode 100644
index 0000000..09eb5d4
--- /dev/null
+++ b/docs/api-cookbook.md
@@ -0,0 +1,59 @@
+# API cookbook
+
+Copy-paste recipes for working with the ToDoRabbit API from a terminal. All examples assume the backend is running on `http://localhost:8000`. See the [API reference](api-reference.md) for every endpoint and field.
+
+## Check that the API is up
+
+```bash
+curl http://localhost:8000/health
+```
+
+You should see `{"status":"healthy"}`.
+
+## Create a todo
+
+```bash
+curl -X POST http://localhost:8000/api/todos \
+  -H "Content-Type: application/json" \
+  -d '{"title": "Book flights", "description": "Check the dates with the team first"}'
+```
+
+The response contains the new todo, including its `id`.
+
+## List open todos
+
+```bash
+curl "http://localhost:8000/api/todos?completed=false"
+```
+
+## Mark a todo as done
+
+Replace `1` with the `id` of the todo you want to update.
+
+```bash
+curl -X PUT http://localhost:8000/api/todo/1 \
+  -H "Content-Type: application/json" \
+  -d '{"completed": true}'
+```
+
+## Archive a todo
+
+```bash
+curl -X POST http://localhost:8000/api/todos/1/archive
+```
+
+Archived todos are hidden from the default list.
+
+## List archived todos too
+
+```bash
+curl "http://localhost:8000/api/todos?archived=true"
+```
+
+## Delete a todo
+
+```bash
+curl -X DELETE http://localhost:8000/api/todos/1
+```
+
+A successful delete returns `204 No Content` and an empty body.

From 3c9d27b29fc776f938803634787eb11312ed6498 Mon Sep 17 00:00:00 2001
From: Aleks Volochnev <a.volochnev@gmail.com>
Date: Fri, 9 Oct 2026 21:18:23 +0200
Subject: [PATCH 2/2] Explain why the id matters in the create recipe

---
 docs/api-cookbook.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/api-cookbook.md b/docs/api-cookbook.md
index 09eb5d4..7fc0db5 100644
--- a/docs/api-cookbook.md
+++ b/docs/api-cookbook.md
@@ -18,7 +18,7 @@ curl -X POST http://localhost:8000/api/todos \
   -d '{"title": "Book flights", "description": "Check the dates with the team first"}'
 ```
 
-The response contains the new todo, including its `id`.
+The response contains the new todo, including the `id` you need for the later recipes.
 
 ## List open todos