Tasks
To-dos and projects: who's doing them, their tags, comments and dependencies, saved views, and what is blocked.
Commands
- PostComment on a task
tasks.comment.addAdds a comment. - PostChange what a comment says
tasks.comment.editRewrites a comment. - PostReact to a comment with an emoji
tasks.comment.reactAdds the person's emoji reaction; reacting twice with the same emoji does nothing. - PostDelete a comment
tasks.comment.removeDeletes a comment and its reactions. - PostTake back an emoji reaction
tasks.comment.unreactRemoves the person's reaction with that emoji, if there is one. - PostDelete a tag
tasks.tag.removeDeletes the tag and takes it off every task and saved view. - PostRename a tag
tasks.tag.renameRenames a tag everywhere it's used. - PostAdd a task
tasks.task.createAdds one task, optionally as a subtask, with any fields filled in. - PostAdd several tasks at once
tasks.task.create_manyAdds up to 100 tasks in one change, such as a project and its subtasks. - PostLink a task to a record in another app
tasks.task.linkLinks the task to another app's record, such as the furnace in maintenance. - PostMove a task under another task, or reorder it
tasks.task.moveChanges a task's parent, its place among its siblings, or both. - PostDelete a task and its subtasks
tasks.task.removeDeletes the task, every subtask under it, and their comments. - PostReplace what a task depends on
tasks.task.set_dependenciesSets exactly which tasks must be done before this one can start. - PostMark a task to do, doing, blocked or done
tasks.task.set_stateMoves a task to a state. - PostReplace a task's tags
tasks.task.set_tagsSets exactly these tags on the task, by name, matching existing tags ignoring case and creating the rest. - PostRemove a task's link to another record
tasks.task.unlinkRemoves the link if there is one. - PostStop following a task
tasks.task.unwatchThe person stops hearing about the task. - PostChange a task's details
tasks.task.updateChanges the title, description, priority, assignee, due date, scheduled time or duplicate marker. - PostFollow a task
tasks.task.watchThe person hears about the task's comments and when it's done or blocked. - PostDelete a saved view
tasks.view.removeDeletes the view. - PostSave a view of the tasks
tasks.view.saveSaves a name, a mode and filters as a view that shows as a tab, or replaces an existing view's.
Queries
- GetMentions and changes on the tasks someone follows
tasks.activity.for_personThe Mentions & watched feed, newest first: tasks assigned to the person, comments mentioning them, comments and changes on tasks they watch, and reactions to their comments, leaving out what they did themselves. - GetProjects and how far along they are
tasks.project.listTop-level tasks that have subtasks, with open and done counts and their open subtasks. - GetHow much gets done, and how long things take
tasks.stats.getTasks done per week (starting Monday) or per month, for the last periods, oldest first; the longest and shortest open-to-done times among them; and the open tasks that have been waiting longest. - GetEvery tag, and how much it's used
tasks.tag.listAll tags by name, with how many open and how many total tasks have each. - GetWhat's blocked, and on what
tasks.task.blockedOpen tasks that can't go ahead: marked blocked (maybe waiting until a time), or waiting on an unfinished dependency. - GetOne task in full
tasks.task.getA task with its description, parents, subtasks, what it depends on and what waits on it, tags, links to other apps, comments with their mentions and reactions, and watchers. - GetWhat's ready to do, in order
tasks.task.queueTasks that are ready: not done, not a duplicate, not a project with open subtasks, and not blocked by their state or by an unfinished dependency. - GetFind tasks by words and filters, done included
tasks.task.searchEvery task matching the filters, done ones included unless states says otherwise: open tasks in queue order first, then done ones, most recently done first. - GetThe saved views
tasks.view.listEvery saved view, by name, with its mode and filters.