initial commit

skills/self-hosting/mealie-setup/references/recipe-management.md

@@ -0,0 +1,58 @@
+# Recipe Management via API
+
+Beyond batch importing, the Mealie API supports full CRUD for recipes — useful for bulk deletion, tag assignment, or fixing metadata.
+
+## Authentication (same as batch import)
+
+```python
+import requests
+M = "http://127.0.0.1:9925"
+token = requests.post(f"{M}/api/auth/token",
+    data={"username": "email", "password": "pw", "grant_type": ""},
+    headers={"Content-Type": "application/x-www-form-urlencoded"}
+).json()["access_token"]
+h = {"Authorization": f"Bearer {token}"}
+```
+
+## List all recipes
+
+```python
+r = requests.get(f"{M}/api/recipes?page=1&perPage=100", headers=h)
+data = r.json()  # keys: page, per_page, total, total_pages, items
+for recipe in data["items"]:
+    print(f"[{recipe['id']}] {recipe['name']}")
+```
+
+Pagination: increment `page` until `page > total_pages`.
+
+## Delete recipes (single or bulk)
+
+```python
+# Single
+r = requests.delete(f"{M}/api/recipes/{recipe_id}", headers=h)
+
+# Bulk with keyword filter
+for recipe in data["items"]:
+    if "pork" in recipe["name"].lower():
+        r = requests.delete(f"{M}/api/recipes/{recipe['id']}", headers=h)
+        print(f"Deleted: {recipe['name']} -> {r.status_code}")
+```
+
+HTTP 200 = success. No undo — confirm your filter before running.
+
+## Find by keyword
+
+Check `name`, `slug`, `description`, and `recipeIngredient` for matching terms:
+
+```python
+import json
+txt = json.dumps(recipe).lower()
+if "bacon" in txt:
+    # recipe mentions bacon somewhere
+```
+
+## Notes
+
+- Recipe IDs are UUIDs (e.g. `52fe7e87-49c2-4cd4-b4f3-82ae7e1b102b`), not sequential integers.
+- The list endpoint returns limited fields; fetch individual recipes (`GET /api/recipes/{id}`) for full ingredient/instruction data.
+- Deletion is instant — no trash/recycle bin in Mealie.