Todoist

Writes

• Create task

  read back

  todoist-create-task

  Create one task. With no project_id it goes to the user's Inbox. A due date can be natural language (due_string: "tomorrow at 12:00", "every monday") or a date (due_date).

• Update task

  read back

  todoist-update-task

  Change one task's content, description, labels, priority, due date or deadline; only the fields given change. labels replaces the whole list.

• Close task

  acknowledged

  todoist-close-task

  Complete one task, as the Todoist app does. A regular task moves to history with its subtasks; a recurring task moves to its next date and stays active. Undo with reopen-task.

• Reopen task

  read back

  todoist-reopen-task

  Reopen one completed task. Any completed parent tasks and sections come back too, at the end of their list.

• Move task to project

  read back

  todoist-move-task-to-project

  Move one task, with its subtasks, to another project, outside any section. A shared project's members can then see it.

• Move task to section

  read back

  todoist-move-task-to-section

  Move one task, with its subtasks, into a section. A section in another project moves it to that project too.

• Delete task

  acknowledged

  todoist-delete-task

  Delete one task and all of its subtasks. It cannot be restored through the API.

• Add comment

  read back

  todoist-add-comment

  Add one comment to a task, as the token's user. Nobody is notified by the call itself.

• Create section

  read back

  todoist-create-section

  Create one section in a project, at the end.

• Delete section

  acknowledged

  todoist-delete-section

  Delete one section and every task in it. The tasks are not counted separately: the impact is one section.

Reads

• List projects

  todoist-list-projects

  List the user's active projects, 50 per page, with each one's id, name, parent_id, is_shared, is_archived and inbox_project. Todoist returns next_cursor when there are more; pass it as cursor for the next page.

• Get project

  todoist-get-project

  Get one project by id: name, description, parent_id, color, view style, is_shared and is_archived.

• List sections

  todoist-list-sections

  List active sections, 50 per page, with id, project_id, name and section_order. Give project_id for one project's sections; leave it out for all of them. Todoist returns next_cursor when there are more; pass it as cursor.

• Get section

  todoist-get-section

  Get one section by id: name, description, project_id, section_order and is_archived.

• List labels

  todoist-list-labels

  List the user's personal labels, 100 per page, with id, name, color and is_favorite. Tasks name labels by name, not id. Shared labels that exist only on other people's tasks are not listed. Todoist returns next_cursor when there are more; pass it as cursor.

• List tasks

  todoist-list-tasks

  List active (not completed) tasks, 25 per page, with id, content, description, project_id, section_id, parent_id, labels, priority, due and deadline. Narrow by project_id, section_id, parent_id (its subtasks) or one label name; with none, every active task is listed. Todoist returns next_cursor when there are more; pass it as cursor with the same other inputs. Long task descriptions can cut a page at 64 KB.

• Filter tasks

  todoist-filter-tasks

  List active tasks that match a Todoist filter query, 25 per page, for example "today | overdue", "#Work & p1" or "assigned to: me". One query at a time: the comma operator is not supported. Todoist returns next_cursor when there are more; pass it as cursor with the same query.

• Get task

  todoist-get-task

  Get one active task by id: content, description, project_id, section_id, parent_id, labels, priority (4 is urgent), due, deadline, duration, responsible_uid, checked and updated_at. A completed or deleted task answers 404; use list-completed-tasks for completed ones.

• List completed tasks

  todoist-list-completed-tasks

  List tasks completed between since and until, 25 per page, with id, content, project_id and completed_at. The range may be at most 3 months. Narrow by project_id or a filter query. Todoist returns next_cursor when there are more; pass it as cursor with the same other inputs.

• List task comments

  todoist-list-task-comments

  List the comments on one task, 20 per page, with id, content, posted_uid, posted_at and file_attachment. Todoist returns next_cursor when there are more; pass it as cursor. A comment can be up to 15,000 characters, so a page of long comments can be cut at 64 KB.