Entries & the Action Dispatcher

GET /api/entries — unified read API

Returns combined tasks and shopping items in one call, with optional filters:

curl "http://YOUR_TODOLESS_HOST:7070/api/entries?type=task&status=todo" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"
Query paramValuesNotes
typetask | itemFilter by kind
statusstringFilter by status
assignee_iduser idFilter by assignee
labellabel idFilter by label
shop_idshop idFilter shopping items by shop

POST /api/v1 — action dispatcher

A compact single endpoint for common mutations. The action is passed in the body together with type:

curl -X POST http://YOUR_TODOLESS_HOST:7070/api/v1 \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "complete", "type": "task", "id": "t0abc125"}'
ActionTypeDescription
listtask | itemList entries
filterstask | itemAvailable filters
createtask | itemCreate entry
updatetask | itemUpdate entry
completetask | itemMark complete
assigntask | itemAssign to member
deletetask | itemDelete entry
add_subtasktaskAdd subtask

⚠️ Administrative actions (role changes, blocking users, deleting users) are intentionally not exposed in the public documentation.