> ## 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-tasks
> Todoist Tasks
**Server path:** `/todoist-tasks` | **Type:** Application | **PCID required:** Yes
## Tools
| Tool | Description |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| [`todoist_tasks_close_task_api_v1_tasks_task_id_close_post`](#todoist_tasks_close_task_api_v1_tasks_task_id_close_post) | Close Task |
| [`todoist_tasks_completed_by_completion_date_api_v1_tasks_completed_by_completion_date_get`](#todoist_tasks_completed_by_completion_date_api_v1_tasks_completed_by_completion_date_get) | Tasks Completed By Completion Date |
| [`todoist_tasks_completed_by_due_date_api_v1_tasks_completed_by_due_date_get`](#todoist_tasks_completed_by_due_date_api_v1_tasks_completed_by_due_date_get) | Tasks Completed By Due Date |
| [`todoist_tasks_create_comment_api_v1_comments_post`](#todoist_tasks_create_comment_api_v1_comments_post) | Create Comment |
| [`todoist_tasks_create_label_api_v1_labels_post`](#todoist_tasks_create_label_api_v1_labels_post) | Create Label |
| [`todoist_tasks_create_reminder_api_v1_reminders_post`](#todoist_tasks_create_reminder_api_v1_reminders_post) | Create Reminder |
| [`todoist_tasks_create_task_api_v1_tasks_post`](#todoist_tasks_create_task_api_v1_tasks_post) | Create Task |
| [`todoist_tasks_delete_comment_api_v1_comments_comment_id_delete`](#todoist_tasks_delete_comment_api_v1_comments_comment_id_delete) | Delete Comment |
| [`todoist_tasks_delete_label_api_v1_labels_label_id_delete`](#todoist_tasks_delete_label_api_v1_labels_label_id_delete) | Delete Label |
| [`todoist_tasks_delete_reminder_api_v1_reminders_reminder_id_delete`](#todoist_tasks_delete_reminder_api_v1_reminders_reminder_id_delete) | Delete Reminder |
| [`todoist_tasks_delete_task_api_v1_tasks_task_id_delete`](#todoist_tasks_delete_task_api_v1_tasks_task_id_delete) | Delete Task |
| [`todoist_tasks_get_api_v1_tasks_get`](#todoist_tasks_get_api_v1_tasks_get) | Get Tasks |
| [`todoist_tasks_get_by_filter_api_v1_tasks_filter_get`](#todoist_tasks_get_by_filter_api_v1_tasks_filter_get) | Get Tasks By Filter |
| [`todoist_tasks_get_comment_api_v1_comments_comment_id_get`](#todoist_tasks_get_comment_api_v1_comments_comment_id_get) | Get Comment |
| [`todoist_tasks_get_comments_api_v1_comments_get`](#todoist_tasks_get_comments_api_v1_comments_get) | Get Comments |
| [`todoist_tasks_get_label_api_v1_labels_label_id_get`](#todoist_tasks_get_label_api_v1_labels_label_id_get) | Get Label |
| [`todoist_tasks_get_labels_api_v1_labels_get`](#todoist_tasks_get_labels_api_v1_labels_get) | Get Labels |
| [`todoist_tasks_get_reminder_api_v1_reminders_reminder_id_get`](#todoist_tasks_get_reminder_api_v1_reminders_reminder_id_get) | Get Reminder |
| [`todoist_tasks_get_reminders_api_v1_reminders_get`](#todoist_tasks_get_reminders_api_v1_reminders_get) | Get Reminders |
| [`todoist_tasks_get_task_api_v1_tasks_task_id_get`](#todoist_tasks_get_task_api_v1_tasks_task_id_get) | Get Task |
| [`todoist_tasks_move_task_api_v1_tasks_task_id_move_post`](#todoist_tasks_move_task_api_v1_tasks_task_id_move_post) | Move Task |
| [`todoist_tasks_quick_add_api_v1_tasks_quick_post`](#todoist_tasks_quick_add_api_v1_tasks_quick_post) | Quick Add |
| [`todoist_tasks_reopen_task_api_v1_tasks_task_id_reopen_post`](#todoist_tasks_reopen_task_api_v1_tasks_task_id_reopen_post) | Reopen Task |
| [`todoist_tasks_search_labels_api_v1_labels_search_get`](#todoist_tasks_search_labels_api_v1_labels_search_get) | Search Labels |
| [`todoist_tasks_shared_labels_api_v1_labels_shared_get`](#todoist_tasks_shared_labels_api_v1_labels_shared_get) | Shared Labels |
| [`todoist_tasks_shared_labels_remove_api_v1_labels_shared_remove_post`](#todoist_tasks_shared_labels_remove_api_v1_labels_shared_remove_post) | Shared Labels Remove |
| [`todoist_tasks_shared_labels_rename_api_v1_labels_shared_rename_post`](#todoist_tasks_shared_labels_rename_api_v1_labels_shared_rename_post) | Shared Labels Rename |
| [`todoist_tasks_update_comment_api_v1_comments_comment_id_post`](#todoist_tasks_update_comment_api_v1_comments_comment_id_post) | Update Comment |
| [`todoist_tasks_update_label_api_v1_labels_label_id_post`](#todoist_tasks_update_label_api_v1_labels_label_id_post) | Update Label |
| [`todoist_tasks_update_reminder_api_v1_reminders_reminder_id_post`](#todoist_tasks_update_reminder_api_v1_reminders_reminder_id_post) | Update Reminder |
| [`todoist_tasks_update_task_api_v1_tasks_task_id_post`](#todoist_tasks_update_task_api_v1_tasks_task_id_post) | Update Task |
***
## 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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"task_id": {
"type": "string",
"description": "String ID of the task"
}
},
"required": [
"PCID",
"task_id"
]
}
```
***
## 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. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"since": {
"type": "string",
"description": "Start of the completion date range, inclusive."
},
"until": {
"type": "string",
"description": "End of the completion date range, exclusive."
},
"workspace_id": {
"type": "string",
"description": "Workspace ID to limit completed tasks to."
},
"project_id": {
"type": "string",
"description": "Project ID to limit completed tasks to."
},
"section_id": {
"type": "string",
"description": "Section ID to limit completed tasks to."
},
"parent_id": {
"type": "string",
"description": "Parent task ID to limit completed subtasks to."
},
"filter_query": {
"type": "string",
"description": "Todoist filter query to limit completed tasks."
},
"filter_lang": {
"type": "string",
"description": "Language code used to parse `filter_query`."
},
"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": "Maximum number of completed tasks to return."
},
"public_key": {
"type": "string",
"description": "Public project access key."
}
},
"required": [
"PCID",
"since",
"until"
]
}
```
***
## 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. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"since": {
"type": "string",
"description": "Start of the due date range, inclusive."
},
"until": {
"type": "string",
"description": "End of the due date range, exclusive."
},
"workspace_id": {
"type": "string",
"description": "Workspace ID to limit completed tasks to."
},
"project_id": {
"type": "string",
"description": "Project ID to limit completed tasks to."
},
"section_id": {
"type": "string",
"description": "Section ID to limit completed tasks to."
},
"parent_id": {
"type": "string",
"description": "Parent task ID to limit completed subtasks to."
},
"filter_query": {
"type": "string",
"description": "Todoist filter query to limit completed tasks."
},
"filter_lang": {
"type": "string",
"description": "Language code used to parse `filter_query`."
},
"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": "Maximum number of completed tasks to return."
}
},
"required": [
"PCID",
"since",
"until"
]
}
```
***
## 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 | null | No | — | String ID of the project |
| `task_id` | string | null | No | — | String ID of the task |
| `uids_to_notify` | string\[] | No | — | Optional list of user IDs to notify about this comment. | |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"attachment": {
"type": "object",
"description": "A [File attachment](#tag/Sync/Comments/File-Attachments) object"
},
"content": {
"type": "string",
"description": "Content of the comment"
},
"project_id": {
"type": [
"string",
"null"
],
"description": "String ID of the project"
},
"task_id": {
"type": [
"string",
"null"
],
"description": "String ID of the task"
},
"uids_to_notify": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional list of user IDs to notify about this comment."
}
},
"required": [
"PCID",
"content"
]
}
```
***
## 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 | null | No | — | Position of the new label in the label list |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"color": {
"description": "Label color."
},
"is_favorite": {
"type": "boolean",
"description": "Whether the label is marked as a favorite."
},
"name": {
"type": "string",
"description": "Name of the new label."
},
"order": {
"type": [
"integer",
"null"
],
"description": "Position of the new label in the label list"
}
},
"required": [
"PCID",
"name"
]
}
```
***
## 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 | null | 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 | |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"due": {
"type": "object",
"description": "Due date dictionary for absolute reminders.",
"properties": {
"date": {
"type": "string",
"description": "Absolute reminder date in ISO 8601 format."
},
"string": {
"type": "string",
"description": "Natural-language reminder date."
},
"lang": {
"type": "string",
"description": "Language used to parse the natural-language date."
},
"timezone": {
"type": "string",
"description": "Timezone for the reminder date."
},
"is_recurring": {
"type": "boolean",
"description": "Whether the reminder date is recurring."
}
}
},
"is_urgent": {
"type": "boolean",
"description": "Whether the reminder is an urgent reminder. Urgent reminders trigger an alarm notification on the user's designated urgent reminder device."
},
"minute_offset": {
"type": [
"integer",
"null"
],
"description": "Minutes before due time to trigger (for relative reminders)"
},
"reminder_type": {
"type": "string",
"description": "Type of the reminder: 'relative' or 'absolute'",
"enum": [
"relative",
"absolute"
]
},
"service": {
"description": "The service value"
},
"task_id": {
"type": "string",
"description": "String ID of the task"
}
},
"required": [
"PCID",
"task_id"
]
}
```
***
## todoist\_tasks\_create\_task\_api\_v1\_tasks\_post
Create Task
**Parameters:**
| Parameter | Type | Required | Default | Description | |
| --------------- | --------- | -------- | ------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `assignee_id` | string | null | 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 | null | No | — | Deadline date in YYYY-MM-DD format |
| `description` | string | null | No | — | Task description. |
| `due_date` | string | null | No | — | Due date in RFC 3339 format or similar. See the Due dates section for more details. |
| `due_datetime` | string | null | No | — | Due date and time. See the Due dates section for more details. |
| `due_lang` | string | null | No | — | Due date language code. See the Due dates section for more details. |
| `due_string` | string | null | No | — | Human-readable representation of the due date. See the Due dates section for more details. |
| `duration` | integer | null | No | — | Task duration, in either minutes or days. Only used if `duration_unit` is also provided. |
| `duration_unit` | string | null | No | — | Unit of time for duration. |
| `labels` | string\[] | No | — | List of label names. | |
| `order` | integer | null | No | — | Position of the task in the project or section |
| `parent_id` | string | null | No | — | ID of the parent task |
| `priority` | integer | null | No | — | Task priority from 1 (normal) to 4 (urgent) |
| `project_id` | string | null | 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 | null | No | — | ID of the section to add the task to |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"assignee_id": {
"type": [
"string",
"null"
],
"description": "ID of the user to assign the task to. To find User IDs, use [Get user](#operation/user_info_api_v1_user_get) for your own ID or [Get all collaborators](#operation/get_project_collaborators_api_v1_projects__project_id__collaborators_get) for project members."
},
"content": {
"type": "string",
"description": "Task content."
},
"deadline_date": {
"type": [
"string",
"null"
],
"description": "Deadline date in YYYY-MM-DD format"
},
"description": {
"type": [
"string",
"null"
],
"description": "Task description."
},
"due_date": {
"type": [
"string",
"null"
],
"description": "Due date in RFC 3339 format or similar. See the [Due dates](#tag/Due-dates) section for more details."
},
"due_datetime": {
"type": [
"string",
"null"
],
"description": "Due date and time. See the [Due dates](#tag/Due-dates) section for more details."
},
"due_lang": {
"type": [
"string",
"null"
],
"description": "Due date language code. See the [Due dates](#tag/Due-dates) section for more details."
},
"due_string": {
"type": [
"string",
"null"
],
"description": "Human-readable representation of the due date. See the [Due dates](#tag/Due-dates) section for more details."
},
"duration": {
"type": [
"integer",
"null"
],
"description": "Task duration, in either minutes or days. Only used if `duration_unit` is also provided."
},
"duration_unit": {
"type": [
"string",
"null"
],
"description": "Unit of time for duration.",
"enum": [
"minute",
"day"
]
},
"labels": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of label names."
},
"order": {
"type": [
"integer",
"null"
],
"description": "Position of the task in the project or section"
},
"parent_id": {
"type": [
"string",
"null"
],
"description": "ID of the parent task"
},
"priority": {
"type": [
"integer",
"null"
],
"description": "Task priority from 1 (normal) to 4 (urgent)"
},
"project_id": {
"type": [
"string",
"null"
],
"description": "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": {
"type": [
"string",
"null"
],
"description": "ID of the section to add the task to"
}
},
"required": [
"PCID",
"content"
]
}
```
***
## 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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"comment_id": {
"type": "string",
"description": "String ID of the comment"
}
},
"required": [
"PCID",
"comment_id"
]
}
```
***
## 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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"label_id": {
"type": "string",
"description": "String ID of the label"
}
},
"required": [
"PCID",
"label_id"
]
}
```
***
## 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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"reminder_id": {
"type": "string",
"description": "String ID of the reminder"
}
},
"required": [
"PCID",
"reminder_id"
]
}
```
***
## 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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"task_id": {
"type": "string",
"description": "String ID of the task"
}
},
"required": [
"PCID",
"task_id"
]
}
```
***
## 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 |
```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 tasks from"
},
"section_id": {
"type": "string",
"description": "String ID of the section to get tasks from"
},
"parent_id": {
"type": "string",
"description": "String ID of the parent task to get sub-tasks from"
},
"label": {
"type": "string",
"description": "Filter tasks by label name."
},
"ids": {
"type": "string",
"description": "A list of the task IDs to retrieve, this should be a comma separated list"
},
"goal_id": {
"type": "string",
"description": "Filter tasks linked to this goal (UUID)."
},
"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\_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](https://todoist.com/help/articles/introduction-to-filters-V98wIH). 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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"query": {
"type": "string",
"description": "Filter by any [supported filter](https://todoist.com/help/articles/introduction-to-filters-V98wIH). Multiple filters (using the comma `,` operator) are not supported."
},
"lang": {
"type": "string",
"description": "IETF language tag defining what language filter is written in, if differs from default English"
},
"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\_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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"comment_id": {
"type": "string",
"description": "String ID of the comment"
}
},
"required": [
"PCID",
"comment_id"
]
}
```
***
## 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. |
```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"
},
"task_id": {
"type": "string",
"description": "String ID of the task"
},
"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\_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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"label_id": {
"type": "string",
"description": "String ID of the label"
}
},
"required": [
"PCID",
"label_id"
]
}
```
***
## 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 |
```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\_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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"reminder_id": {
"type": "string",
"description": "String ID of the reminder"
}
},
"required": [
"PCID",
"reminder_id"
]
}
```
***
## 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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"task_id": {
"type": "string",
"description": "String ID of the task"
},
"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\_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. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"task_id": {
"type": "string",
"description": "String ID of the task"
},
"public_key": {
"type": "string",
"description": "Public project access key."
}
},
"required": [
"PCID",
"task_id"
]
}
```
***
## 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 | null | No | — | ID of the parent task to move the task under |
| `project_id` | string | null | No | — | ID of the project to move the task to |
| `section_id` | string | null | No | — | ID of the section to move the task to |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"task_id": {
"type": "string",
"description": "ID of the task to move"
},
"parent_id": {
"type": [
"string",
"null"
],
"description": "ID of the parent task to move the task under"
},
"project_id": {
"type": [
"string",
"null"
],
"description": "ID of the project to move the task to"
},
"section_id": {
"type": [
"string",
"null"
],
"description": "ID of the section to move the task to"
}
},
"required": [
"PCID",
"task_id"
]
}
```
***
## 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 | null | 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 | null | 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. | |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"auto_reminder": {
"type": "boolean",
"description": "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](#tag/Sync/User) for more info about the default reminder."
},
"meta": {
"type": "boolean",
"description": "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": {
"type": [
"string",
"null"
],
"description": "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": {
"type": [
"string",
"null"
],
"description": "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": {
"type": "string",
"description": "The text of the task to parse using Quick Add syntax. See the endpoint description for supported syntax elements."
}
},
"required": [
"PCID",
"text"
]
}
```
***
## 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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"task_id": {
"type": "string",
"description": "String ID of the task"
}
},
"required": [
"PCID",
"task_id"
]
}
```
***
## 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 |
```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 label 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\_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 |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"omit_personal": {
"type": "boolean",
"description": "Whether to exclude the user's personal labels from the shared label names."
},
"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\_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. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"name": {
"type": "string",
"description": "Shared label name to remove from matching tasks."
}
},
"required": [
"PCID",
"name"
]
}
```
***
## 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. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"name": {
"type": "string",
"description": "Current shared label name to rename."
},
"new_name": {
"type": "string",
"description": "New shared label name to apply to matching tasks."
}
},
"required": [
"PCID",
"name",
"new_name"
]
}
```
***
## 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 | null | Yes | — | New content for the comment. If null or an empty string, no update is performed. |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"comment_id": {
"type": "string",
"description": "String ID of the comment"
},
"content": {
"type": [
"string",
"null"
],
"description": "New content for the comment. If null or an empty string, no update is performed."
}
},
"required": [
"PCID",
"comment_id",
"content"
]
}
```
***
## 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 | null | No | — | Whether the label is marked as a favorite. Passing null or omitting this field will leave it unchanged. |
| `name` | string | null | No | — | Updated label name. Passing null or omitting this field will leave it unchanged. |
| `order` | integer | null | No | — | Position of the label in the label list. 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"
},
"label_id": {
"type": "string",
"description": "String ID of the label"
},
"color": {
"description": "Label color. Passing null or omitting this field will leave it unchanged."
},
"is_favorite": {
"type": [
"boolean",
"null"
],
"description": "Whether the label is marked as a favorite. Passing null or omitting this field will leave it unchanged."
},
"name": {
"type": [
"string",
"null"
],
"description": "Updated label name. Passing null or omitting this field will leave it unchanged."
},
"order": {
"type": [
"integer",
"null"
],
"description": "Position of the label in the label list. Passing null or omitting this field will leave it unchanged."
}
},
"required": [
"PCID",
"label_id"
]
}
```
***
## 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 | null | No | — | Minutes before due time to trigger (for relative reminders). |
| `service` | object | No | — | The service value | |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"reminder_id": {
"type": "string",
"description": "String ID of the reminder"
},
"due": {
"type": "object",
"description": "Due date dictionary for absolute reminders.",
"properties": {
"date": {
"type": "string",
"description": "Absolute reminder date in ISO 8601 format."
},
"string": {
"type": "string",
"description": "Natural-language reminder date."
},
"lang": {
"type": "string",
"description": "Language used to parse the natural-language date."
},
"timezone": {
"type": "string",
"description": "Timezone for the reminder date."
},
"is_recurring": {
"type": "boolean",
"description": "Whether the reminder date is recurring."
}
}
},
"is_urgent": {
"type": "boolean",
"description": "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": {
"type": [
"integer",
"null"
],
"description": "Minutes before due time to trigger (for relative reminders)."
},
"service": {
"description": "The service value"
}
},
"required": [
"PCID",
"reminder_id"
]
}
```
***
## 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 | null | 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 | null | 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 | null | 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 | null | 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. | |
```json theme={null}
{
"type": "object",
"properties": {
"PCID": {
"type": "string",
"description": "Pink Connect ID for the authenticated connection"
},
"task_id": {
"type": "string",
"description": "String ID of the task"
},
"assignee_id": {
"type": [
"string",
"null"
],
"description": "ID of the user to assign the task to. To find User IDs, use [Get user](#operation/user_info_api_v1_user_get) for your own ID or [Get all collaborators](#operation/get_project_collaborators_api_v1_projects__project_id__collaborators_get) for project members. Pass null to clear the value. Omit this field to keep it unchanged."
},
"child_order": {
"type": "integer",
"description": "Updated position of the task in its current scope. Omit this field to keep it unchanged."
},
"content": {
"type": "string",
"description": "Updated task content. Omit this field to keep it unchanged."
},
"day_order": {
"type": "integer",
"description": "Updated position of the task in Today and Upcoming views. Omit this field to keep it unchanged."
},
"deadline_date": {
"type": [
"string",
"null"
],
"description": "Updated deadline date in YYYY-MM-DD format. Pass null to clear the value. Omit this field to keep it unchanged."
},
"description": {
"type": "string",
"description": "Updated task description. Omit this field to keep it unchanged."
},
"due_date": {
"type": "string",
"description": "Updated due date in RFC 3339 format or similar. See the [Due dates](#tag/Due-dates) section for more details. Omit this field to keep it unchanged."
},
"due_datetime": {
"type": "string",
"description": "Updated due date and time. See the [Due dates](#tag/Due-dates) section for more details. Omit this field to keep it unchanged."
},
"due_lang": {
"type": "string",
"description": "Updated due date language code. See the [Due dates](#tag/Due-dates) section for more details. Omit this field to keep it unchanged."
},
"due_string": {
"type": "string",
"description": "Updated human-readable representation of the due date. See the [Due dates](#tag/Due-dates) section for more details. Omit this field to keep it unchanged."
},
"duration": {
"type": [
"integer",
"null"
],
"description": "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": {
"type": [
"string",
"null"
],
"description": "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.",
"enum": [
"minute",
"day"
]
},
"is_collapsed": {
"type": "boolean",
"description": "Updated collapsed state of the task for the current user. Omit this field to keep it unchanged."
},
"labels": {
"type": "array",
"items": {
"type": "string"
},
"description": "Updated list of label names. Omit this field to keep it unchanged."
},
"priority": {
"type": "integer",
"description": "Updated task priority from 1 (normal) to 4 (urgent). Omit this field to keep it unchanged."
}
},
"required": [
"PCID",
"task_id"
]
}
```