Todoist tools
The 13 Todoist operations your product runs on your customer's account through Connect. All of them use the same endpoint, POST /api/tools/{tool}/execute.
- List projectsGETLists the active projects the account can access. The response has results and next_cursor: pass next_cursor as cursor to read the next page.
- Create projectPOSTCreates a project and returns it. Without workspace_id it is a personal project of the account.
- Update projectPOSTUpdates a project and returns it. Fields left out keep their value.
- List project collaboratorsGETLists the people who share a project, with id, name and email. The id is what assignee_id and uids_to_notify take. The response has results and next_cursor: pass next_cursor as cursor to read the next page.
- List tasksGETLists the active tasks, optionally narrowed to a project, section, parent task or label. Completed tasks are not included. The response has results and next_cursor: pass next_cursor as cursor, with the same filters, to read the next page.
- Search tasksGETReturns the active tasks that match a filter query, in the same syntax as the filters of the app. The response has results and next_cursor: pass next_cursor as cursor, with the same query, to read the next page.
- Get taskGETReturns one active task by id. A completed task is not returned.
- Create taskPOSTCreates a task and returns it. Without project_id the task goes to the Inbox. Set the due date with one of due_string, due_date or due_datetime.
- Update taskPOSTUpdates a task and returns it. Fields left out keep their value. It does not move the task to another project or section.
- Close taskPOSTCompletes a task, like checking it off in the app. A regular task moves to history with its sub-tasks; a recurring task moves to its next date instead.
- Delete taskDELETEDeletes a task together with all of its sub-tasks. To complete a task, use Close task instead.
- List commentsGETLists the comments of a task or of a project. Send exactly one of task_id or project_id. The response has results and next_cursor: pass next_cursor as cursor to read the next page.
- Create commentPOSTAdds a comment to a task or to a project and returns it. Send exactly one of task_id or project_id. The users in uids_to_notify are notified.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
