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"
  }'
FieldTypeNotes
titlestring (required)Item name
quantitystringQuantity text (e.g. '2', '1 kg')
shop_idstringShop to buy from (see shops collection)
labelsarray of label idsValidated against family and visibility rules
assigned_touser idAssignee
due_datedateISO date
prioritynumberPriority 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"