Lists and items
Get sidebar
GetList returns one List and its Items, in their manual order. The four groups a sidebar draws, each capped and each saying how many there are. Its own call rather than a page of ListLists: a sidebar is four bounded reads with four totals, and asking for that as pages would be four round trips to draw one column.
Response Body
application/json
application/json
curl -X GET "https://example.com/api/v1/sidebar"{ "pinned": { "lists": [ { "uid": "string", "name": "string", "sharing": "SHARING_UNSPECIFIED", "canEdit": true, "isOwner": true, "isPinned": true, "openCount": 0, "doneCount": 0, "createdAt": "string", "updatedAt": "string", "archivedAt": "string", "archivedByName": "string" } ], "total": 0, "atLeast": true }, "mine": { "lists": [ { "uid": "string", "name": "string", "sharing": "SHARING_UNSPECIFIED", "canEdit": true, "isOwner": true, "isPinned": true, "openCount": 0, "doneCount": 0, "createdAt": "string", "updatedAt": "string", "archivedAt": "string", "archivedByName": "string" } ], "total": 0, "atLeast": true }, "shared": { "lists": [ { "uid": "string", "name": "string", "sharing": "SHARING_UNSPECIFIED", "canEdit": true, "isOwner": true, "isPinned": true, "openCount": 0, "doneCount": 0, "createdAt": "string", "updatedAt": "string", "archivedAt": "string", "archivedByName": "string" } ], "total": 0, "atLeast": true }, "completed": { "lists": [ { "uid": "string", "name": "string", "sharing": "SHARING_UNSPECIFIED", "canEdit": true, "isOwner": true, "isPinned": true, "openCount": 0, "doneCount": 0, "createdAt": "string", "updatedAt": "string", "archivedAt": "string", "archivedByName": "string" } ], "total": 0, "atLeast": true }}Get list shares
GetListShares returns who a List reaches by name, for the share dialog.
List dated items
ListDatedItems returns unticked Items with a due date, across every List the Member can reach. Today, Upcoming and the calendar are all views over this: a calendar is a lens on dates, not a second home for Lists.