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 param | Values | Notes |
|---|---|---|
| type | task | item | Filter by kind |
| status | string | Filter by status |
| assignee_id | user id | Filter by assignee |
| label | label id | Filter by label |
| shop_id | shop id | Filter 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"}'
| Action | Type | Description |
|---|---|---|
| list | task | item | List entries |
| filters | task | item | Available filters |
| create | task | item | Create entry |
| update | task | item | Update entry |
| complete | task | item | Mark complete |
| assign | task | item | Assign to member |
| delete | task | item | Delete entry |
| add_subtask | task | Add subtask |
⚠️ Administrative actions (role changes, blocking users, deleting users) are intentionally not exposed in the public documentation.