1. Docs
2. /
3. Tool reference
4. /
5. Tasks & My Day

Tasks & My Day

To-dos, task lists, and the daily page: the user's plan for today and what is outstanding.

32 verbs in this family.

• addToMyDay write Append content to the user's My Day page for a date.
• addToMyDayLibrary write Save an item to the user's files: defaults to today's My Day folder (the daily folder), or pass an explicit folderId to route to another folder.
• completeMatchingTodo write Find the incomplete Task matching a completion report and mark it complete in one step.
• convertMyDayListToTaskBlocks write Convert bullet lists in a My Day page to checkbox/task blocks.
• createLabel write Create a label in a personal or shared Space for Tasks.
• createProject write Create a Cloud Project : the container a body of work lives in, so a brief and its Tasks belong to something a later session can open, instead of being loose Pages.
• createStatus write Create a workflow status for a Task list.
• createTask write Create a Task: a to-do item in a task list.
• createTodo write Create a Task: a to-do item in a task list.
• createTodoList write Create a task list: the container a Task belongs to.
• deleteTodo writedestructive Delete a Task: moves it to Trash (recoverable), matching the app's delete.
• getListTaskCounts read Count Tasks per list, ranked.
• linkTaskToPage write Link a Task to a Page or build doc.
• linkTaskToPr write Link a Task to a GitHub pull request using its full HTTPS URL.
• listProjects read List Cloud Projects : the named containers that hold a body of work: its chats, its instructions, and the Tasks filed under it.
• listTaskLabels read List the Task labels that already exist in a scope: each with its id, name, and color.
• listTaskLists read List the user's task lists: the containers a Task belongs to.
• listTasks read List Tasks with optional text, status, priority, assignee, list, project, completion, and due-date filters.
• listTaskStatuses read List the workflow statuses a Task list already has: each with its id, name, glyph, and workflow group: plus which status is the default per group and whether the list shows a Kanban board.
• listTodos read List Tasks with optional text, status, priority, assignee, list, project, completion, and due-date filters.
• moveTaskListToSpace write Move a task list to a Space root so it lives with that project.
• moveTaskToList write Move a Task to a different list.
• readLedger read Read the lane ledger: the owner's Task list where every agent lane files itself, with each row that carries a run or a pull request, grouped by workflow status.
• readMyDay read Read the user's My Day page for a date: one daily page per calendar date.
• readMyDayLibrary read Read the user's My Day library collection (a folder) for a date: the daily collection of saved files and links that mirrors the My Day page.
• readProject read Read one Cloud Project in full: its name, stage, Space, canonical url, the instructions that seed AI context for its chats, and how many Tasks are filed under it (open and completed counts; call…
• readTask read Read one Task in full by id.
• toggleTodo write Mark a Task complete or incomplete.
• updateMyDayTask write Edit, re-check, or delete a SINGLE task block in a My Day page: in place, leaving every sibling block untouched.
• updateProject write Update a Cloud Project: rename it, replace its instructions, move it along its stage (todo, in_progress, complete), or change its icon.
• updateTask write Update a Task's text, priority, or due date.
• updateTodo write Update a Task's text, priority, or due date.