Groceries & Shopping
Shopping items (groceries) with quantities, shops and prices keep the family list in sync.
Create a shopping item
curl -X POST http://YOUR_TODOLESS_HOST:7070/api/groceries \
-H "Authorization: Bearer YOUR_SESSION_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"title": "Oat milk",
"quantity": "2",
"shop_id": "sh0abc1",
"labels": ["l0abc2"],
"due_date": "2026-10-01"
}'
| Field | Type | Notes |
|---|---|---|
| title | string (required) | Item name |
| quantity | string | Quantity text (e.g. '2', '1 kg') |
| shop_id | string | Shop to buy from (see shops collection) |
| labels | array of label ids | Validated against family and visibility rules |
| assigned_to | user id | Assignee |
| due_date | date | ISO date |
| priority | number | Priority level |
Complete / update an item
curl -X PATCH http://YOUR_TODOLESS_HOST:7070/api/groceries/ITEM_ID \
-H "Authorization: Bearer YOUR_SESSION_TOKEN" \
-H "Content-Type: application/json" \
-d '{"completed": true}'
Items, shops and labels collections
curl "http://YOUR_TODOLESS_HOST:7070/api/collections/items/records" -H "Authorization: Bearer YOUR_SESSION_TOKEN"
curl "http://YOUR_TODOLESS_HOST:7070/api/collections/shops/records" -H "Authorization: Bearer YOUR_SESSION_TOKEN"