> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# todoist-projects
> Todoist Projects
**Server path:** `/todoist-projects` | **Type:** Application | **PCID required:** Yes
## Tools
| Tool | Description |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
| [`todoist_projects_archive_project_api_v1_projects_project_id_archive_post`](#todoist_projects_archive_project_api_v1_projects_project_id_archive_post) | Archive Project |
| [`todoist_projects_archive_section_api_v1_sections_section_id_archive_post`](#todoist_projects_archive_section_api_v1_sections_section_id_archive_post) | Archive Section |
| [`todoist_projects_create_folder_api_v1_folders_post`](#todoist_projects_create_folder_api_v1_folders_post) | Create Folder |
| [`todoist_projects_create_project_api_v1_projects_post`](#todoist_projects_create_project_api_v1_projects_post) | Create Project |
| [`todoist_projects_create_section_api_v1_sections_post`](#todoist_projects_create_section_api_v1_sections_post) | Create Section |
| [`todoist_projects_delete_folder_api_v1_folders_folder_id_delete`](#todoist_projects_delete_folder_api_v1_folders_folder_id_delete) | Delete Folder |
| [`todoist_projects_delete_project_api_v1_projects_project_id_delete`](#todoist_projects_delete_project_api_v1_projects_project_id_delete) | Delete Project |
| [`todoist_projects_delete_section_api_v1_sections_section_id_delete`](#todoist_projects_delete_section_api_v1_sections_section_id_delete) | Delete Section |
| [`todoist_projects_get_activity_logs_api_v1_activities_get`](#todoist_projects_get_activity_logs_api_v1_activities_get) | Get Activity Logs |
| [`todoist_projects_get_api_v1_projects_get`](#todoist_projects_get_api_v1_projects_get) | Get Projects |
| [`todoist_projects_get_archived_api_v1_projects_archived_get`](#todoist_projects_get_archived_api_v1_projects_archived_get) | Get Archived |
| [`todoist_projects_get_folder_api_v1_folders_folder_id_get`](#todoist_projects_get_folder_api_v1_folders_folder_id_get) | Get Folder |
| [`todoist_projects_get_folders_api_v1_folders_get`](#todoist_projects_get_folders_api_v1_folders_get) | Get Folders |
| [`todoist_projects_get_productivity_stats_api_v1_tasks_completed_stats_get`](#todoist_projects_get_productivity_stats_api_v1_tasks_completed_stats_get) | Get Productivity Stats |
| [`todoist_projects_get_project_api_v1_projects_project_id_get`](#todoist_projects_get_project_api_v1_projects_project_id_get) | Get Project |
| [`todoist_projects_get_project_collaborators_api_v1_projects_project_id_collaborators_get`](#todoist_projects_get_project_collaborators_api_v1_projects_project_id_collaborators_get) | Get Project Collaborators |
| [`todoist_projects_get_section_api_v1_sections_section_id_get`](#todoist_projects_get_section_api_v1_sections_section_id_get) | Get Section |
| [`todoist_projects_get_sections_api_v1_sections_get`](#todoist_projects_get_sections_api_v1_sections_get) | Get Sections |
| [`todoist_projects_join_api_v1_projects_project_id_join_post`](#todoist_projects_join_api_v1_projects_project_id_join_post) | Join |
| [`todoist_projects_permissions_api_v1_projects_permissions_get`](#todoist_projects_permissions_api_v1_projects_permissions_get) | Permissions |
| [`todoist_projects_search_projects_api_v1_projects_search_get`](#todoist_projects_search_projects_api_v1_projects_search_get) | Search Projects |
| [`todoist_projects_search_sections_api_v1_sections_search_get`](#todoist_projects_search_sections_api_v1_sections_search_get) | Search Sections |
| [`todoist_projects_unarchive_project_api_v1_projects_project_id_unarchive_post`](#todoist_projects_unarchive_project_api_v1_projects_project_id_unarchive_post) | Unarchive Project |
| [`todoist_projects_unarchive_section_api_v1_sections_section_id_unarchive_post`](#todoist_projects_unarchive_section_api_v1_sections_section_id_unarchive_post) | Unarchive Section |
| [`todoist_projects_update_folder_api_v1_folders_folder_id_post`](#todoist_projects_update_folder_api_v1_folders_folder_id_post) | Update Folder |
| [`todoist_projects_update_notification_setting_api_v1_notification_setting_put`](#todoist_projects_update_notification_setting_api_v1_notification_setting_put) | Update Notification Setting |
| [`todoist_projects_update_project_api_v1_projects_project_id_post`](#todoist_projects_update_project_api_v1_projects_project_id_post) | Update Project |
| [`todoist_projects_update_section_api_v1_sections_section_id_post`](#todoist_projects_update_section_api_v1_sections_section_id_post) | Update Section |
| [`todoist_projects_user_info_api_v1_user_get`](#todoist_projects_user_info_api_v1_user_get) | User Info |
***
## 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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"project_id": {
"type": "string",
"description": "String ID of the project"
}
},
"required": [
"PCID",
"project_id"
]
}
```
***
## 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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"section_id": {
"type": "string",
"description": "String ID of the section"
}
},
"required": [
"PCID",
"section_id"
]
}
```
***
## todoist\_projects\_create\_folder\_api\_v1\_folders\_post
Create Folder
**Parameters:**
| Parameter | Type | Required | Default | Description | |
| --------------- | ------- | -------- | ------- | -------------------------------------------- | ------------------------------------------------ |
| `child_order` | integer | null | No | — | User-specific position of the folder. |
| `default_order` | integer | null | 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. | |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"child_order": {
"type": [
"integer",
"null"
],
"description": "User-specific position of the folder."
},
"default_order": {
"type": [
"integer",
"null"
],
"description": "Default position of the folder in the workspace."
},
"name": {
"type": "string",
"description": "Name of the new folder."
},
"workspace_id": {
"type": "string",
"description": "ID of the workspace to create the folder in."
}
},
"required": [
"PCID",
"name",
"workspace_id"
]
}
```
***
## 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 | null | No | — | Description of the project. |
| `is_favorite` | boolean | No | — | Whether the project is a favorite for the user. | |
| `name` | string | null | Yes | — | Name of the project. |
| `parent_id` | string | null | No | — | Parent project ID. If provided, creates this project as a sub-project |
| `view_style` | string | null | No | — | View style of the project. |
| `workspace_id` | string | null | No | — | Workspace ID. If provided, creates a workspace project instead of a personal project. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"color": {
"description": "Color of the project icon."
},
"description": {
"type": [
"string",
"null"
],
"description": "Description of the project."
},
"is_favorite": {
"type": "boolean",
"description": "Whether the project is a favorite for the user."
},
"name": {
"type": [
"string",
"null"
],
"description": "Name of the project."
},
"parent_id": {
"type": [
"string",
"null"
],
"description": "Parent project ID. If provided, creates this project as a sub-project"
},
"view_style": {
"type": [
"string",
"null"
],
"description": "View style of the project.",
"enum": [
"list",
"board",
"calendar"
]
},
"workspace_id": {
"type": [
"string",
"null"
],
"description": "Workspace ID. If provided, creates a workspace project instead of a personal project."
}
},
"required": [
"PCID",
"name"
]
}
```
***
## 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 | null | No | — | Position of the new section in the project |
| `project_id` | string | Yes | — | ID of the project to add the section to | |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"name": {
"type": "string",
"description": "Name of the new section."
},
"order": {
"type": [
"integer",
"null"
],
"description": "Position of the new section in the project"
},
"project_id": {
"type": "string",
"description": "ID of the project to add the section to"
}
},
"required": [
"PCID",
"name",
"project_id"
]
}
```
***
## 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. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"folder_id": {
"type": "string",
"description": "ID of the folder to delete."
}
},
"required": [
"PCID",
"folder_id"
]
}
```
***
## 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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"project_id": {
"type": "string",
"description": "String ID of the project"
}
},
"required": [
"PCID",
"project_id"
]
}
```
***
## 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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"section_id": {
"type": "string",
"description": "String ID of the section"
}
},
"required": [
"PCID",
"section_id"
]
}
```
***
## 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. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"object_type": {
"type": "string",
"description": "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.",
"enum": [
"project",
"item",
"note",
"section"
]
},
"object_id": {
"description": "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=`."
},
"parent_project_id": {
"description": "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": {
"description": "Filter activities to only those belonging to the specified task. Returns activities for the task itself and all its comments."
},
"include_parent_object": {
"type": "boolean",
"description": "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": {
"type": "boolean",
"description": "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": {
"description": "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": {
"type": "boolean",
"description": "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": {
"type": "string",
"description": "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": {
"type": "boolean",
"description": "**Deprecated** - This parameter has no implementation and will be removed in a future version."
},
"object_event_types": {
"type": "array",
"items": {
"type": "string"
},
"description": "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": {
"description": "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": {
"type": "boolean",
"description": "When `true`, includes additional information about comments in the `extra_data` field, such as the content of the comment."
},
"annotate_parents": {
"type": "boolean",
"description": "When `true`, includes additional information about parent objects in the `extra_data` field, such as the name of the parent project or task."
},
"cursor": {
"type": "string",
"description": "Pagination cursor for fetching the next page of results. Use the value returned in the `next_cursor` field from a previous response."
},
"limit": {
"type": "integer",
"description": "The number of objects to return in a page"
},
"date_from": {
"type": "string",
"description": "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": {
"type": "string",
"description": "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."
}
},
"required": [
"PCID"
]
}
```
***
## 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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"folder_id": {
"type": "string",
"description": "Filter projects to only those in this folder. If provided, workspace_id is ignored."
},
"workspace_id": {
"type": "string",
"description": "Filter projects to only those in this workspace. Ignored if folder_id is also provided."
},
"cursor": {
"type": "string",
"description": "An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request"
},
"limit": {
"type": "integer",
"description": "The number of objects to return in a page"
}
},
"required": [
"PCID"
]
}
```
***
## 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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"cursor": {
"type": "string",
"description": "An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request"
},
"limit": {
"type": "integer",
"description": "The number of objects to return in a page"
}
},
"required": [
"PCID"
]
}
```
***
## 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. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"folder_id": {
"type": "string",
"description": "ID of the folder to return."
}
},
"required": [
"PCID",
"folder_id"
]
}
```
***
## 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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"workspace_id": {
"type": "string",
"description": "ID of the workspace to list folders for."
},
"cursor": {
"type": "string",
"description": "An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request"
},
"limit": {
"type": "integer",
"description": "The number of objects to return in a page"
}
},
"required": [
"PCID",
"workspace_id"
]
}
```
***
## todoist\_projects\_get\_productivity\_stats\_api\_v1\_tasks\_completed\_stats\_get
Get Productivity Stats
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
}
},
"required": [
"PCID"
]
}
```
***
## todoist\_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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"project_id": {
"type": "string",
"description": "String ID of the project"
}
},
"required": [
"PCID",
"project_id"
]
}
```
***
## 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. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"project_id": {
"type": "string",
"description": "String ID of the project"
},
"cursor": {
"type": "string",
"description": "An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request"
},
"limit": {
"type": "integer",
"description": "The number of objects to return in a page"
},
"public_key": {
"type": "string",
"description": "Public project access key."
}
},
"required": [
"PCID",
"project_id"
]
}
```
***
## 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. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"section_id": {
"type": "string",
"description": "String ID of the section"
},
"public_key": {
"type": "string",
"description": "Public project access key."
}
},
"required": [
"PCID",
"section_id"
]
}
```
***
## 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. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"project_id": {
"type": "string",
"description": "String ID of the project to get sections from. If omitted or null, get sections from all projects."
},
"cursor": {
"type": "string",
"description": "An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request"
},
"limit": {
"type": "integer",
"description": "The number of objects to return in a page"
},
"public_key": {
"type": "string",
"description": "Public project access key."
}
},
"required": [
"PCID"
]
}
```
***
## 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. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"project_id": {
"type": "string",
"description": "String ID of the workspace project to join."
}
},
"required": [
"PCID",
"project_id"
]
}
```
***
## todoist\_projects\_permissions\_api\_v1\_projects\_permissions\_get
Permissions
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
}
},
"required": [
"PCID"
]
}
```
***
## todoist\_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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"query": {
"type": "string",
"description": "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": {
"type": "string",
"description": "An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request"
},
"limit": {
"type": "integer",
"description": "The number of objects to return in a page"
}
},
"required": [
"PCID",
"query"
]
}
```
***
## 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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"query": {
"type": "string",
"description": "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": {
"type": "string",
"description": "String ID of the project to search sections from. If omitted or null, search sections from all projects."
},
"cursor": {
"type": "string",
"description": "An opaque string used as the cursor for pagination. Must be used with the same parameters from the previous request"
},
"limit": {
"type": "integer",
"description": "The number of objects to return in a page"
}
},
"required": [
"PCID",
"query"
]
}
```
***
## 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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"project_id": {
"type": "string",
"description": "String ID of the project"
}
},
"required": [
"PCID",
"project_id"
]
}
```
***
## 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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"section_id": {
"type": "string",
"description": "String ID of the section"
}
},
"required": [
"PCID",
"section_id"
]
}
```
***
## 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 | null | No | — | Updated default position of the folder. Passing null or omitting this field will leave it unchanged. |
| `name` | string | null | No | — | Updated folder name. Passing null or omitting this field will leave it unchanged. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"folder_id": {
"type": "string",
"description": "ID of the folder to update."
},
"default_order": {
"type": [
"integer",
"null"
],
"description": "Updated default position of the folder. Passing null or omitting this field will leave it unchanged."
},
"name": {
"type": [
"string",
"null"
],
"description": "Updated folder name. Passing null or omitting this field will leave it unchanged."
}
},
"required": [
"PCID",
"folder_id"
]
}
```
***
## todoist\_projects\_update\_notification\_setting\_api\_v1\_notification\_setting\_put
Update Notification Setting
**Parameters:**
| Parameter | Type | Required | Default | Description | |
| ------------------- | ------- | -------- | ------- | --------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| `dont_notify` | boolean | null | 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 | |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"dont_notify": {
"type": [
"boolean",
"null"
],
"description": "Whether notifications should be disabled for the selected type and channel."
},
"notification_type": {
"type": "string",
"description": "The type of notification being sent",
"enum": [
"note_added",
"item_assigned",
"item_completed",
"item_uncompleted",
"karma_level",
"share_invitation_sent",
"share_invitation_accepted",
"share_invitation_rejected",
"share_invitation_blocked_by_project_limit",
"user_left_project",
"user_removed_from_project",
"teams_workspace_upgraded",
"teams_workspace_canceled",
"teams_workspace_payment_failed",
"pro_trial_started",
"pro_trial_ended",
"workspace_invitation_created",
"workspace_invitation_accepted",
"workspace_invitation_rejected",
"project_archived",
"project_moved",
"removed_from_workspace",
"workspace_deleted",
"message",
"workspace_user_joined_by_domain",
"price_increase_new_pro_users",
"price_increase_new_team",
"price_increase_new_team_trial",
"price_increase_android",
"workspace_team_cohort_tagged"
]
},
"service": {
"type": "string",
"description": "Which communication mechanism is being used to send this notification",
"enum": [
"email",
"push"
]
}
},
"required": [
"PCID",
"notification_type",
"service"
]
}
```
***
## 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 | null | 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 | null | No | — | Updated project description. Passing null or omitting this field will leave it unchanged. |
| `folder_id` | string | null | 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 | null | No | — | Whether the project is collapsed. Passing null or omitting this field will leave it unchanged. |
| `is_favorite` | boolean | null | No | — | Whether the project is marked as a favorite. Passing null or omitting this field will leave it unchanged. |
| `name` | string | null | No | — | Updated project name. Passing null or omitting this field will leave it unchanged. |
| `view_style` | string | null | No | — | Updated project view style. Passing null or omitting this field will leave it unchanged. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"project_id": {
"type": "string",
"description": "String ID of the project"
},
"child_order": {
"type": [
"integer",
"null"
],
"description": "Updated position of the project in the hierarchy. Only supported for personal projects. Passing null or omitting this field will leave it unchanged."
},
"color": {
"description": "Updated project color. Passing null or omitting this field will leave it unchanged."
},
"description": {
"type": [
"string",
"null"
],
"description": "Updated project description. Passing null or omitting this field will leave it unchanged."
},
"folder_id": {
"type": [
"string",
"null"
],
"description": "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": {
"type": [
"boolean",
"null"
],
"description": "Whether the project is collapsed. Passing null or omitting this field will leave it unchanged."
},
"is_favorite": {
"type": [
"boolean",
"null"
],
"description": "Whether the project is marked as a favorite. Passing null or omitting this field will leave it unchanged."
},
"name": {
"type": [
"string",
"null"
],
"description": "Updated project name. Passing null or omitting this field will leave it unchanged."
},
"view_style": {
"type": [
"string",
"null"
],
"description": "Updated project view style. Passing null or omitting this field will leave it unchanged.",
"enum": [
"list",
"board",
"calendar"
]
}
},
"required": [
"PCID",
"project_id"
]
}
```
***
## 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 | null | No | — | Updated collapsed state of the section. Passing null or omitting this field will leave it unchanged. |
| `name` | string | null | No | — | Updated section name. Passing null or omitting this field will leave it unchanged. |
| `section_order` | integer | null | No | — | Updated position of the section in the project. Passing null or omitting this field will leave it unchanged. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"section_id": {
"type": "string",
"description": "String ID of the section"
},
"is_collapsed": {
"type": [
"boolean",
"null"
],
"description": "Updated collapsed state of the section. Passing null or omitting this field will leave it unchanged."
},
"name": {
"type": [
"string",
"null"
],
"description": "Updated section name. Passing null or omitting this field will leave it unchanged."
},
"section_order": {
"type": [
"integer",
"null"
],
"description": "Updated position of the section in the project. Passing null or omitting this field will leave it unchanged."
}
},
"required": [
"PCID",
"section_id"
]
}
```
***
## todoist\_projects\_user\_info\_api\_v1\_user\_get
User Info
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
}
},
"required": [
"PCID"
]
}
```