/todoist-tasks | Type: Application | PCID required: Yes
Tools
todoist_tasks_close_task_api_v1_tasks_task_id_close_post
Close Task Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | Yes | — | String ID of the task |
todoist_tasks_completed_by_completion_date_api_v1_tasks_completed_by_completion_date_get
Tasks Completed By Completion Date Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
since | string | Yes | — | Start of the completion date range, inclusive. |
until | string | Yes | — | End of the completion date range, exclusive. |
workspace_id | string | No | — | Workspace ID to limit completed tasks to. |
project_id | string | No | — | Project ID to limit completed tasks to. |
section_id | string | No | — | Section ID to limit completed tasks to. |
parent_id | string | No | — | Parent task ID to limit completed subtasks to. |
filter_query | string | No | — | Todoist filter query to limit completed tasks. |
filter_lang | string | No | — | Language code used to parse filter_query. |
cursor | string | No | — | An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request |
limit | integer | No | — | Maximum number of completed tasks to return. |
public_key | string | No | — | Public project access key. |
todoist_tasks_completed_by_due_date_api_v1_tasks_completed_by_due_date_get
Tasks Completed By Due Date Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
since | string | Yes | — | Start of the due date range, inclusive. |
until | string | Yes | — | End of the due date range, exclusive. |
workspace_id | string | No | — | Workspace ID to limit completed tasks to. |
project_id | string | No | — | Project ID to limit completed tasks to. |
section_id | string | No | — | Section ID to limit completed tasks to. |
parent_id | string | No | — | Parent task ID to limit completed subtasks to. |
filter_query | string | No | — | Todoist filter query to limit completed tasks. |
filter_lang | string | No | — | Language code used to parse filter_query. |
cursor | string | No | — | An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request |
limit | integer | No | — | Maximum number of completed tasks to return. |
todoist_tasks_create_comment_api_v1_comments_post
Create Comment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
attachment | object | No | — | A File attachment object |
content | string | Yes | — | Content of the comment |
project_id | string | No | — | String ID of the project |
task_id | string | No | — | String ID of the task |
uids_to_notify | string[] | No | — | Optional list of user IDs to notify about this comment. |
todoist_tasks_create_label_api_v1_labels_post
Create Label Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
color | object | No | — | Label color. |
is_favorite | boolean | No | — | Whether the label is marked as a favorite. |
name | string | Yes | — | Name of the new label. |
order | integer | No | — | Position of the new label in the label list |
todoist_tasks_create_reminder_api_v1_reminders_post
Create Reminder Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
due | object | No | — | Due date dictionary for absolute reminders. |
is_urgent | boolean | No | — | Whether the reminder is an urgent reminder. Urgent reminders trigger an alarm notification on the user’s designated urgent reminder device. |
minute_offset | integer | No | — | Minutes before due time to trigger (for relative reminders) |
reminder_type | string | No | — | Type of the reminder: ‘relative’ or ‘absolute’ |
service | object | No | — | The service value |
task_id | string | Yes | — | String ID of the task |
todoist_tasks_create_task_api_v1_tasks_post
Create Task Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
assignee_id | string | No | — | ID 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. |
content | string | Yes | — | Task content. |
deadline_date | string | No | — | Deadline date in YYYY-MM-DD format |
description | string | No | — | Task description. |
due_date | string | No | — | Due date in RFC 3339 format or similar. See the Due dates section for more details. |
due_datetime | string | No | — | Due date and time. See the Due dates section for more details. |
due_lang | string | No | — | Due date language code. See the Due dates section for more details. |
due_string | string | No | — | Human-readable representation of the due date. See the Due dates section for more details. |
duration | integer | No | — | Task duration, in either minutes or days. Only used if duration_unit is also provided. |
duration_unit | string | No | — | Unit of time for duration. |
labels | string[] | No | — | List of label names. |
order | integer | No | — | Position of the task in the project or section |
parent_id | string | No | — | ID of the parent task |
priority | integer | No | — | Task priority from 1 (normal) to 4 (urgent) |
project_id | string | No | — | ID of the project to add the task to. If omitted or null, the task will be added to the user’s Inbox. |
section_id | string | No | — | ID of the section to add the task to |
todoist_tasks_delete_comment_api_v1_comments_comment_id_delete
Delete Comment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
comment_id | string | Yes | — | String ID of the comment |
todoist_tasks_delete_label_api_v1_labels_label_id_delete
Delete Label Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
label_id | string | Yes | — | String ID of the label |
todoist_tasks_delete_reminder_api_v1_reminders_reminder_id_delete
Delete Reminder Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
reminder_id | string | Yes | — | String ID of the reminder |
todoist_tasks_delete_task_api_v1_tasks_task_id_delete
Delete Task Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | Yes | — | String ID of the task |
todoist_tasks_get_api_v1_tasks_get
Get Tasks Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | No | — | String ID of the project to get tasks from |
section_id | string | No | — | String ID of the section to get tasks from |
parent_id | string | No | — | String ID of the parent task to get sub-tasks from |
label | string | No | — | Filter tasks by label name. |
ids | string | No | — | A list of the task IDs to retrieve, this should be a comma separated list |
goal_id | string | No | — | Filter tasks linked to this goal (UUID). |
cursor | string | No | — | An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request |
limit | integer | No | — | The number of objects to return in a page |
todoist_tasks_get_by_filter_api_v1_tasks_filter_get
Get Tasks By Filter Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | — | Filter by any supported filter. Multiple filters (using the comma , operator) are not supported. |
lang | string | No | — | IETF language tag defining what language filter is written in, if differs from default English |
cursor | string | No | — | An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request |
limit | integer | No | — | The number of objects to return in a page |
todoist_tasks_get_comment_api_v1_comments_comment_id_get
Get Comment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
comment_id | string | Yes | — | String ID of the comment |
todoist_tasks_get_comments_api_v1_comments_get
Get Comments Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | No | — | String ID of the project |
task_id | string | No | — | String ID of the task |
cursor | string | No | — | An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request |
limit | integer | No | — | The number of objects to return in a page |
public_key | string | No | — | Public project access key. |
todoist_tasks_get_label_api_v1_labels_label_id_get
Get Label Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
label_id | string | Yes | — | String ID of the label |
todoist_tasks_get_labels_api_v1_labels_get
Get Labels Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
cursor | string | No | — | An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request |
limit | integer | No | — | The number of objects to return in a page |
todoist_tasks_get_reminder_api_v1_reminders_reminder_id_get
Get Reminder Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
reminder_id | string | Yes | — | String ID of the reminder |
todoist_tasks_get_reminders_api_v1_reminders_get
Get Reminders Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | No | — | String ID of the task |
cursor | string | No | — | An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request |
limit | integer | No | — | The number of objects to return in a page |
todoist_tasks_get_task_api_v1_tasks_task_id_get
Get Task Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | Yes | — | String ID of the task |
public_key | string | No | — | Public project access key. |
todoist_tasks_move_task_api_v1_tasks_task_id_move_post
Move Task Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | Yes | — | ID of the task to move |
parent_id | string | No | — | ID of the parent task to move the task under |
project_id | string | No | — | ID of the project to move the task to |
section_id | string | No | — | ID of the section to move the task to |
todoist_tasks_quick_add_api_v1_tasks_quick_post
Quick Add Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
auto_reminder | boolean | No | — | When 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. |
meta | boolean | No | — | When 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. |
note | string | No | — | A 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. |
reminder | string | No | — | A 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. |
text | string | Yes | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | Yes | — | String ID of the task |
todoist_tasks_search_labels_api_v1_labels_search_get
Search Labels Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | — | Search 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. |
cursor | string | No | — | An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request |
limit | integer | No | — | The number of objects to return in a page |
todoist_tasks_shared_labels_api_v1_labels_shared_get
Shared Labels Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
omit_personal | boolean | No | — | Whether to exclude the user’s personal labels from the shared label names. |
cursor | string | No | — | An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request |
limit | integer | No | — | The number of objects to return in a page |
todoist_tasks_shared_labels_remove_api_v1_labels_shared_remove_post
Shared Labels Remove Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | Yes | — | Shared label name to remove from matching tasks. |
todoist_tasks_shared_labels_rename_api_v1_labels_shared_rename_post
Shared Labels Rename Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | Yes | — | Current shared label name to rename. |
new_name | string | Yes | — | New shared label name to apply to matching tasks. |
todoist_tasks_update_comment_api_v1_comments_comment_id_post
Update Comment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
comment_id | string | Yes | — | String ID of the comment |
content | string | Yes | — | New 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
label_id | string | Yes | — | String ID of the label |
color | object | No | — | Label color. Passing null or omitting this field will leave it unchanged. |
is_favorite | boolean | No | — | Whether the label is marked as a favorite. Passing null or omitting this field will leave it unchanged. |
name | string | No | — | Updated label name. Passing null or omitting this field will leave it unchanged. |
order | integer | No | — | Position 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
reminder_id | string | Yes | — | String ID of the reminder |
due | object | No | — | Due date dictionary for absolute reminders. |
is_urgent | boolean | No | — | Whether 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_offset | integer | No | — | Minutes before due time to trigger (for relative reminders). |
service | object | No | — | The service value |
todoist_tasks_update_task_api_v1_tasks_task_id_post
Update Task Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task_id | string | Yes | — | String ID of the task |
assignee_id | string | No | — | ID 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_order | integer | No | — | Updated position of the task in its current scope. Omit this field to keep it unchanged. |
content | string | No | — | Updated task content. Omit this field to keep it unchanged. |
day_order | integer | No | — | Updated position of the task in Today and Upcoming views. Omit this field to keep it unchanged. |
deadline_date | string | No | — | Updated deadline date in YYYY-MM-DD format. Pass null to clear the value. Omit this field to keep it unchanged. |
description | string | No | — | Updated task description. Omit this field to keep it unchanged. |
due_date | string | No | — | Updated due date in RFC 3339 format or similar. See the Due dates section for more details. Omit this field to keep it unchanged. |
due_datetime | string | No | — | Updated due date and time. See the Due dates section for more details. Omit this field to keep it unchanged. |
due_lang | string | No | — | Updated due date language code. See the Due dates section for more details. Omit this field to keep it unchanged. |
due_string | string | No | — | Updated human-readable representation of the due date. See the Due dates section for more details. Omit this field to keep it unchanged. |
duration | integer | No | — | Updated 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_unit | string | No | — | Unit 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_collapsed | boolean | No | — | Updated collapsed state of the task for the current user. Omit this field to keep it unchanged. |
labels | string[] | No | — | Updated list of label names. Omit this field to keep it unchanged. |
priority | integer | No | — | Updated task priority from 1 (normal) to 4 (urgent). Omit this field to keep it unchanged. |

