Skip to main content
Server path: /todoist-tasks | Type: Application | PCID required: Yes

Tools

ToolDescription
todoist_tasks_close_task_api_v1_tasks_task_id_close_postClose Task
todoist_tasks_completed_by_completion_date_api_v1_tasks_completed_by_completion_date_getTasks Completed By Completion Date
todoist_tasks_completed_by_due_date_api_v1_tasks_completed_by_due_date_getTasks Completed By Due Date
todoist_tasks_create_comment_api_v1_comments_postCreate Comment
todoist_tasks_create_label_api_v1_labels_postCreate Label
todoist_tasks_create_reminder_api_v1_reminders_postCreate Reminder
todoist_tasks_create_task_api_v1_tasks_postCreate Task
todoist_tasks_delete_comment_api_v1_comments_comment_id_deleteDelete Comment
todoist_tasks_delete_label_api_v1_labels_label_id_deleteDelete Label
todoist_tasks_delete_reminder_api_v1_reminders_reminder_id_deleteDelete Reminder
todoist_tasks_delete_task_api_v1_tasks_task_id_deleteDelete Task
todoist_tasks_get_api_v1_tasks_getGet Tasks
todoist_tasks_get_by_filter_api_v1_tasks_filter_getGet Tasks By Filter
todoist_tasks_get_comment_api_v1_comments_comment_id_getGet Comment
todoist_tasks_get_comments_api_v1_comments_getGet Comments
todoist_tasks_get_label_api_v1_labels_label_id_getGet Label
todoist_tasks_get_labels_api_v1_labels_getGet Labels
todoist_tasks_get_reminder_api_v1_reminders_reminder_id_getGet Reminder
todoist_tasks_get_reminders_api_v1_reminders_getGet Reminders
todoist_tasks_get_task_api_v1_tasks_task_id_getGet Task
todoist_tasks_move_task_api_v1_tasks_task_id_move_postMove Task
todoist_tasks_quick_add_api_v1_tasks_quick_postQuick Add
todoist_tasks_reopen_task_api_v1_tasks_task_id_reopen_postReopen Task
todoist_tasks_search_labels_api_v1_labels_search_getSearch Labels
todoist_tasks_shared_labels_api_v1_labels_shared_getShared Labels
todoist_tasks_shared_labels_remove_api_v1_labels_shared_remove_postShared Labels Remove
todoist_tasks_shared_labels_rename_api_v1_labels_shared_rename_postShared Labels Rename
todoist_tasks_update_comment_api_v1_comments_comment_id_postUpdate Comment
todoist_tasks_update_label_api_v1_labels_label_id_postUpdate Label
todoist_tasks_update_reminder_api_v1_reminders_reminder_id_postUpdate Reminder
todoist_tasks_update_task_api_v1_tasks_task_id_postUpdate Task

todoist_tasks_close_task_api_v1_tasks_task_id_close_post

Close Task Parameters:
ParameterTypeRequiredDefaultDescription
task_idstringYesString ID of the task

todoist_tasks_completed_by_completion_date_api_v1_tasks_completed_by_completion_date_get

Tasks Completed By Completion Date Parameters:
ParameterTypeRequiredDefaultDescription
sincestringYesStart of the completion date range, inclusive.
untilstringYesEnd of the completion date range, exclusive.
workspace_idstringNoWorkspace ID to limit completed tasks to.
project_idstringNoProject ID to limit completed tasks to.
section_idstringNoSection ID to limit completed tasks to.
parent_idstringNoParent task ID to limit completed subtasks to.
filter_querystringNoTodoist filter query to limit completed tasks.
filter_langstringNoLanguage code used to parse filter_query.
cursorstringNoAn opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
limitintegerNoMaximum number of completed tasks to return.
public_keystringNoPublic project access key.

todoist_tasks_completed_by_due_date_api_v1_tasks_completed_by_due_date_get

Tasks Completed By Due Date Parameters:
ParameterTypeRequiredDefaultDescription
sincestringYesStart of the due date range, inclusive.
untilstringYesEnd of the due date range, exclusive.
workspace_idstringNoWorkspace ID to limit completed tasks to.
project_idstringNoProject ID to limit completed tasks to.
section_idstringNoSection ID to limit completed tasks to.
parent_idstringNoParent task ID to limit completed subtasks to.
filter_querystringNoTodoist filter query to limit completed tasks.
filter_langstringNoLanguage code used to parse filter_query.
cursorstringNoAn opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
limitintegerNoMaximum number of completed tasks to return.

todoist_tasks_create_comment_api_v1_comments_post

Create Comment Parameters:
ParameterTypeRequiredDefaultDescription
attachmentobjectNoA File attachment object
contentstringYesContent of the comment
project_idstringNoString ID of the project
task_idstringNoString ID of the task
uids_to_notifystring[]NoOptional list of user IDs to notify about this comment.

todoist_tasks_create_label_api_v1_labels_post

Create Label Parameters:
ParameterTypeRequiredDefaultDescription
colorobjectNoLabel color.
is_favoritebooleanNoWhether the label is marked as a favorite.
namestringYesName of the new label.
orderintegerNoPosition of the new label in the label list

todoist_tasks_create_reminder_api_v1_reminders_post

Create Reminder Parameters:
ParameterTypeRequiredDefaultDescription
dueobjectNoDue date dictionary for absolute reminders.
is_urgentbooleanNoWhether the reminder is an urgent reminder. Urgent reminders trigger an alarm notification on the user’s designated urgent reminder device.
minute_offsetintegerNoMinutes before due time to trigger (for relative reminders)
reminder_typestringNoType of the reminder: ‘relative’ or ‘absolute’
serviceobjectNoThe service value
task_idstringYesString ID of the task

todoist_tasks_create_task_api_v1_tasks_post

Create Task Parameters:
ParameterTypeRequiredDefaultDescription
assignee_idstringNoID of the user to assign the task to. To find User IDs, use Get user for your own ID or Get all collaborators for project members.
contentstringYesTask content.
deadline_datestringNoDeadline date in YYYY-MM-DD format
descriptionstringNoTask description.
due_datestringNoDue date in RFC 3339 format or similar. See the Due dates section for more details.
due_datetimestringNoDue date and time. See the Due dates section for more details.
due_langstringNoDue date language code. See the Due dates section for more details.
due_stringstringNoHuman-readable representation of the due date. See the Due dates section for more details.
durationintegerNoTask duration, in either minutes or days. Only used if duration_unit is also provided.
duration_unitstringNoUnit of time for duration.
labelsstring[]NoList of label names.
orderintegerNoPosition of the task in the project or section
parent_idstringNoID of the parent task
priorityintegerNoTask priority from 1 (normal) to 4 (urgent)
project_idstringNoID of the project to add the task to. If omitted or null, the task will be added to the user’s Inbox.
section_idstringNoID of the section to add the task to

todoist_tasks_delete_comment_api_v1_comments_comment_id_delete

Delete Comment Parameters:
ParameterTypeRequiredDefaultDescription
comment_idstringYesString ID of the comment

todoist_tasks_delete_label_api_v1_labels_label_id_delete

Delete Label Parameters:
ParameterTypeRequiredDefaultDescription
label_idstringYesString ID of the label

todoist_tasks_delete_reminder_api_v1_reminders_reminder_id_delete

Delete Reminder Parameters:
ParameterTypeRequiredDefaultDescription
reminder_idstringYesString ID of the reminder

todoist_tasks_delete_task_api_v1_tasks_task_id_delete

Delete Task Parameters:
ParameterTypeRequiredDefaultDescription
task_idstringYesString ID of the task

todoist_tasks_get_api_v1_tasks_get

Get Tasks Parameters:
ParameterTypeRequiredDefaultDescription
project_idstringNoString ID of the project to get tasks from
section_idstringNoString ID of the section to get tasks from
parent_idstringNoString ID of the parent task to get sub-tasks from
labelstringNoFilter tasks by label name.
idsstringNoA list of the task IDs to retrieve, this should be a comma separated list
goal_idstringNoFilter tasks linked to this goal (UUID).
cursorstringNoAn opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
limitintegerNoThe number of objects to return in a page

todoist_tasks_get_by_filter_api_v1_tasks_filter_get

Get Tasks By Filter Parameters:
ParameterTypeRequiredDefaultDescription
querystringYesFilter by any supported filter. Multiple filters (using the comma , operator) are not supported.
langstringNoIETF language tag defining what language filter is written in, if differs from default English
cursorstringNoAn opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
limitintegerNoThe number of objects to return in a page

todoist_tasks_get_comment_api_v1_comments_comment_id_get

Get Comment Parameters:
ParameterTypeRequiredDefaultDescription
comment_idstringYesString ID of the comment

todoist_tasks_get_comments_api_v1_comments_get

Get Comments Parameters:
ParameterTypeRequiredDefaultDescription
project_idstringNoString ID of the project
task_idstringNoString ID of the task
cursorstringNoAn opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
limitintegerNoThe number of objects to return in a page
public_keystringNoPublic project access key.

todoist_tasks_get_label_api_v1_labels_label_id_get

Get Label Parameters:
ParameterTypeRequiredDefaultDescription
label_idstringYesString ID of the label

todoist_tasks_get_labels_api_v1_labels_get

Get Labels Parameters:
ParameterTypeRequiredDefaultDescription
cursorstringNoAn opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
limitintegerNoThe number of objects to return in a page

todoist_tasks_get_reminder_api_v1_reminders_reminder_id_get

Get Reminder Parameters:
ParameterTypeRequiredDefaultDescription
reminder_idstringYesString ID of the reminder

todoist_tasks_get_reminders_api_v1_reminders_get

Get Reminders Parameters:
ParameterTypeRequiredDefaultDescription
task_idstringNoString ID of the task
cursorstringNoAn opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
limitintegerNoThe number of objects to return in a page

todoist_tasks_get_task_api_v1_tasks_task_id_get

Get Task Parameters:
ParameterTypeRequiredDefaultDescription
task_idstringYesString ID of the task
public_keystringNoPublic project access key.

todoist_tasks_move_task_api_v1_tasks_task_id_move_post

Move Task Parameters:
ParameterTypeRequiredDefaultDescription
task_idstringYesID of the task to move
parent_idstringNoID of the parent task to move the task under
project_idstringNoID of the project to move the task to
section_idstringNoID of the section to move the task to

todoist_tasks_quick_add_api_v1_tasks_quick_post

Quick Add Parameters:
ParameterTypeRequiredDefaultDescription
auto_reminderbooleanNoWhen enabled, the default reminder will be added to the new item if it has a due date with time set. See also the auto_reminder user option for more info about the default reminder.
metabooleanNoWhen enabled, the response includes a meta object containing the detailed parsing results. This shows exactly how the Quick Add text was interpreted, including which project, labels, due date, priority, etc. were detected. Useful for debugging parsing behavior or building integrations that need to understand how text was parsed.
notestringNoA note to attach to the task. The note content is added as a comment on the created task. If the user’s plan does not support comments, this parameter is ignored.
reminderstringNoA reminder date in natural language format, similar to due date parsing. If the user’s plan does not support reminders, this parameter is ignored. If the reminder text cannot be parsed, it is silently ignored.
textstringYesThe text of the task to parse using Quick Add syntax. See the endpoint description for supported syntax elements.

todoist_tasks_reopen_task_api_v1_tasks_task_id_reopen_post

Reopen Task Parameters:
ParameterTypeRequiredDefaultDescription
task_idstringYesString ID of the task

todoist_tasks_search_labels_api_v1_labels_search_get

Search Labels Parameters:
ParameterTypeRequiredDefaultDescription
querystringYesSearch query to match label names. Matching is case-insensitive. Queries are matched literally unless * (wildcard) is included. Use \* for literal asterisk and \\ for literal backslash.
cursorstringNoAn opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
limitintegerNoThe number of objects to return in a page

todoist_tasks_shared_labels_api_v1_labels_shared_get

Shared Labels Parameters:
ParameterTypeRequiredDefaultDescription
omit_personalbooleanNoWhether to exclude the user’s personal labels from the shared label names.
cursorstringNoAn opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request
limitintegerNoThe number of objects to return in a page

todoist_tasks_shared_labels_remove_api_v1_labels_shared_remove_post

Shared Labels Remove Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesShared label name to remove from matching tasks.

todoist_tasks_shared_labels_rename_api_v1_labels_shared_rename_post

Shared Labels Rename Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesCurrent shared label name to rename.
new_namestringYesNew shared label name to apply to matching tasks.

todoist_tasks_update_comment_api_v1_comments_comment_id_post

Update Comment Parameters:
ParameterTypeRequiredDefaultDescription
comment_idstringYesString ID of the comment
contentstringYesNew content for the comment. If null or an empty string, no update is performed.

todoist_tasks_update_label_api_v1_labels_label_id_post

Update Label Parameters:
ParameterTypeRequiredDefaultDescription
label_idstringYesString ID of the label
colorobjectNoLabel color. Passing null or omitting this field will leave it unchanged.
is_favoritebooleanNoWhether the label is marked as a favorite. Passing null or omitting this field will leave it unchanged.
namestringNoUpdated label name. Passing null or omitting this field will leave it unchanged.
orderintegerNoPosition of the label in the label list. Passing null or omitting this field will leave it unchanged.

todoist_tasks_update_reminder_api_v1_reminders_reminder_id_post

Update Reminder Parameters:
ParameterTypeRequiredDefaultDescription
reminder_idstringYesString ID of the reminder
dueobjectNoDue date dictionary for absolute reminders.
is_urgentbooleanNoWhether the reminder is an urgent reminder. Urgent reminders trigger an alarm notification on the user’s designated urgent reminder device. Omit this field to keep it unchanged.
minute_offsetintegerNoMinutes before due time to trigger (for relative reminders).
serviceobjectNoThe service value

todoist_tasks_update_task_api_v1_tasks_task_id_post

Update Task Parameters:
ParameterTypeRequiredDefaultDescription
task_idstringYesString ID of the task
assignee_idstringNoID of the user to assign the task to. To find User IDs, use Get user for your own ID or Get all collaborators for project members. Pass null to clear the value. Omit this field to keep it unchanged.
child_orderintegerNoUpdated position of the task in its current scope. Omit this field to keep it unchanged.
contentstringNoUpdated task content. Omit this field to keep it unchanged.
day_orderintegerNoUpdated position of the task in Today and Upcoming views. Omit this field to keep it unchanged.
deadline_datestringNoUpdated deadline date in YYYY-MM-DD format. Pass null to clear the value. Omit this field to keep it unchanged.
descriptionstringNoUpdated task description. Omit this field to keep it unchanged.
due_datestringNoUpdated due date in RFC 3339 format or similar. See the Due dates section for more details. Omit this field to keep it unchanged.
due_datetimestringNoUpdated due date and time. See the Due dates section for more details. Omit this field to keep it unchanged.
due_langstringNoUpdated due date language code. See the Due dates section for more details. Omit this field to keep it unchanged.
due_stringstringNoUpdated human-readable representation of the due date. See the Due dates section for more details. Omit this field to keep it unchanged.
durationintegerNoUpdated task duration, in either minutes or days. Only used if duration_unit is also provided. Pass null to clear the value. Omit this field to keep it unchanged.
duration_unitstringNoUnit of time for duration. Must be provided to update the task duration. Pass null to clear the value. Omit this field to keep it unchanged.
is_collapsedbooleanNoUpdated collapsed state of the task for the current user. Omit this field to keep it unchanged.
labelsstring[]NoUpdated list of label names. Omit this field to keep it unchanged.
priorityintegerNoUpdated task priority from 1 (normal) to 4 (urgent). Omit this field to keep it unchanged.