/todoist-projects | Type: Application | PCID required: Yes
Tools
todoist_projects_archive_project_api_v1_projects_project_id_archive_post
Archive Project Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | Yes | — | String ID of the project |
todoist_projects_archive_section_api_v1_sections_section_id_archive_post
Archive Section Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
section_id | string | Yes | — | String ID of the section |
todoist_projects_create_folder_api_v1_folders_post
Create Folder Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
child_order | integer | No | — | User-specific position of the folder. |
default_order | integer | No | — | Default position of the folder in the workspace. |
name | string | Yes | — | Name of the new folder. |
workspace_id | string | Yes | — | ID of the workspace to create the folder in. |
todoist_projects_create_project_api_v1_projects_post
Create Project Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
color | object | No | — | Color of the project icon. |
description | string | No | — | Description of the project. |
is_favorite | boolean | No | — | Whether the project is a favorite for the user. |
name | string | Yes | — | Name of the project. |
parent_id | string | No | — | Parent project ID. If provided, creates this project as a sub-project |
view_style | string | No | — | View style of the project. |
workspace_id | string | No | — | Workspace ID. If provided, creates a workspace project instead of a personal project. |
todoist_projects_create_section_api_v1_sections_post
Create Section Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | Yes | — | Name of the new section. |
order | integer | No | — | Position of the new section in the project |
project_id | string | Yes | — | ID of the project to add the section to |
todoist_projects_delete_folder_api_v1_folders_folder_id_delete
Delete Folder Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
folder_id | string | Yes | — | ID of the folder to delete. |
todoist_projects_delete_project_api_v1_projects_project_id_delete
Delete Project Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | Yes | — | String ID of the project |
todoist_projects_delete_section_api_v1_sections_section_id_delete
Delete Section Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
section_id | string | Yes | — | String ID of the section |
todoist_projects_get_activity_logs_api_v1_activities_get
Get Activity Logs Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
object_type | string | No | — | The type of object to filter activities by. Must be one of “project”, “item” (task), “note” (comment), or “section”. When specified with object_id, returns activities for that specific object. |
object_id | object | No | — | The ID of the specific object to get activities for. Must be used together with object_type. For example, to get activities for a specific task, set object_type=item and object_id=<task_id>. |
parent_project_id | object | No | — | Filter activities to only those belonging to the specified project. Returns activities for the project itself and all its tasks and comments. |
parent_item_id | object | No | — | Filter activities to only those belonging to the specified task. Returns activities for the task itself and all its comments. |
include_parent_object | boolean | No | — | When true and object_id is specified, also include activities for the parent object. For example, when filtering by a specific task, also include activities for its parent project. |
include_child_objects | boolean | No | — | When true and object_id is specified, also include activities for all child objects. For example, when filtering by a project, also include activities for all its tasks and comments. |
initiator_id | object | No | — | Filter activities to only those initiated by the specified user ID(s). Accepts either a single user ID or a list of user IDs. Useful for shared projects to see who made which changes. |
initiator_id_null | boolean | No | — | Filter by whether the activity has an initiator. When true, returns only activities with no initiator (your own activities). When false, returns only activities initiated by collaborators. |
event_type | string | No | — | Filter by a simple event type (e.g., “added”, “deleted”, “completed”). Returns events of this type across ALL object types that support it. For more precise filtering by both object type and event type, use object_event_types instead. |
ensure_last_state | boolean | No | — | Deprecated - This parameter has no implementation and will be removed in a future version. |
object_event_types | string[] | No | — | Advanced filtering for specific object type and event type combinations. Format: ["object_type:event_type"]. Examples: ["item:deleted"] for deleted tasks, ["item:"] for all task events, [":deleted"] for all delete events across all types, ["item:deleted", "note:added"] for multiple filters. Valid event types: “added”, “deleted”, “updated”, “completed”, “uncompleted”, “archived”, “unarchived”, “shared”, “left”, “reordered”, “moved”. This is the recommended way to filter events. |
workspace_id | object | No | — | Filter activities by workspace. Accepts a single workspace ID, a list of workspace IDs, or null to filter for personal projects (projects not belonging to any workspace). Use [null, 123] to include both personal projects and workspace 123. When not set, returns activities from all workspaces and personal projects. |
annotate_notes | boolean | No | — | When true, includes additional information about comments in the extra_data field, such as the content of the comment. |
annotate_parents | boolean | No | — | When true, includes additional information about parent objects in the extra_data field, such as the name of the parent project or task. |
cursor | string | No | — | Pagination cursor for fetching the next page of results. Use the value returned in the next_cursor field from a previous response. |
limit | integer | No | — | The number of objects to return in a page |
date_from | string | No | — | Filter activities to only those that occurred on or after this date. Must be in ISO 8601 format (e.g. ‘2026-01-01T00:00:00Z’). When specified, overrides the default pagination behavior and allows custom date ranges. |
date_to | string | No | — | Filter activities to only those that occurred before this date (exclusive upper bound). Must be in ISO 8601 format (e.g. ‘2026-02-01T00:00:00Z’). When specified, overrides the default pagination behavior and allows custom date ranges. |
todoist_projects_get_api_v1_projects_get
Get Projects Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
folder_id | string | No | — | Filter projects to only those in this folder. If provided, workspace_id is ignored. |
workspace_id | string | No | — | Filter projects to only those in this workspace. Ignored if folder_id is also provided. |
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_projects_get_archived_api_v1_projects_archived_get
Get Archived 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_projects_get_folder_api_v1_folders_folder_id_get
Get Folder Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
folder_id | string | Yes | — | ID of the folder to return. |
todoist_projects_get_folders_api_v1_folders_get
Get Folders Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
workspace_id | string | Yes | — | ID of the workspace to list folders for. |
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_projects_get_productivity_stats_api_v1_tasks_completed_stats_get
Get Productivity Statstodoist_projects_get_project_api_v1_projects_project_id_get
Get Project Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | Yes | — | String ID of the project |
todoist_projects_get_project_collaborators_api_v1_projects_project_id_collaborators_get
Get Project Collaborators Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | Yes | — | String ID of the project |
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_projects_get_section_api_v1_sections_section_id_get
Get Section Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
section_id | string | Yes | — | String ID of the section |
public_key | string | No | — | Public project access key. |
todoist_projects_get_sections_api_v1_sections_get
Get Sections Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | No | — | String ID of the project to get sections from. If omitted or null, get sections from all projects. |
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_projects_join_api_v1_projects_project_id_join_post
Join Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | Yes | — | String ID of the workspace project to join. |
todoist_projects_permissions_api_v1_projects_permissions_get
Permissionstodoist_projects_search_projects_api_v1_projects_search_get
Search Projects Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | — | Search query to match project 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_projects_search_sections_api_v1_sections_search_get
Search Sections Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | — | Search query to match section names. Matching is case-insensitive. Queries are matched literally unless * (wildcard) is included. Use \* for literal asterisk and \\ for literal backslash. |
project_id | string | No | — | String ID of the project to search sections from. If omitted or null, search sections from all projects. |
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_projects_unarchive_project_api_v1_projects_project_id_unarchive_post
Unarchive Project Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | Yes | — | String ID of the project |
todoist_projects_unarchive_section_api_v1_sections_section_id_unarchive_post
Unarchive Section Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
section_id | string | Yes | — | String ID of the section |
todoist_projects_update_folder_api_v1_folders_folder_id_post
Update Folder Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
folder_id | string | Yes | — | ID of the folder to update. |
default_order | integer | No | — | Updated default position of the folder. Passing null or omitting this field will leave it unchanged. |
name | string | No | — | Updated folder name. Passing null or omitting this field will leave it unchanged. |
todoist_projects_update_notification_setting_api_v1_notification_setting_put
Update Notification Setting Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
dont_notify | boolean | No | — | Whether notifications should be disabled for the selected type and channel. |
notification_type | string | Yes | — | The type of notification being sent |
service | string | Yes | — | Which communication mechanism is being used to send this notification |
todoist_projects_update_project_api_v1_projects_project_id_post
Update Project Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
project_id | string | Yes | — | String ID of the project |
child_order | integer | No | — | Updated position of the project in the hierarchy. Only supported for personal projects. Passing null or omitting this field will leave it unchanged. |
color | object | No | — | Updated project color. Passing null or omitting this field will leave it unchanged. |
description | string | No | — | Updated project description. Passing null or omitting this field will leave it unchanged. |
folder_id | string | No | — | Folder to move the project into. Only supported for workspace projects. Pass null to clear the value. Omit this field to keep it unchanged. |
is_collapsed | boolean | No | — | Whether the project is collapsed. Passing null or omitting this field will leave it unchanged. |
is_favorite | boolean | No | — | Whether the project is marked as a favorite. Passing null or omitting this field will leave it unchanged. |
name | string | No | — | Updated project name. Passing null or omitting this field will leave it unchanged. |
view_style | string | No | — | Updated project view style. Passing null or omitting this field will leave it unchanged. |
todoist_projects_update_section_api_v1_sections_section_id_post
Update Section Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
section_id | string | Yes | — | String ID of the section |
is_collapsed | boolean | No | — | Updated collapsed state of the section. Passing null or omitting this field will leave it unchanged. |
name | string | No | — | Updated section name. Passing null or omitting this field will leave it unchanged. |
section_order | integer | No | — | Updated position of the section in the project. Passing null or omitting this field will leave it unchanged. |

