Todoist
Todoist 是一個在線任務管理應用程序和待辦事項列表。 使用 Todoist，用戶可以組織、安排、維護個人任務並確定其優先級。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 標準 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 標準 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 標準 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft |
| URL |
Microsoft LogicApps 支援 Microsoft Power Automate 支援 Microsoft Power Apps 支援 |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
| 網站 | https://todoist.com/ |
| 隱私策略 | https://todoist.com/privacy |
這很重要
由於 Todoist 對 REST API （v1） 的棄用，目前無法使用連接器的所有操作和觸發器。 為了切換到新版本，請 在此處投票。
要使用此集成，您需要訪問 Todoist 帳戶。 若要建立連線，請選取 [登入]。 系統將提示您提供您的 Todoist 登錄名，按照其餘屏幕創建連接。 請注意，連接器中的某些操作可能需要 Todoist Premium 帳戶，如果您發現其中一項操作失敗，請查看消息並確認您的帳戶類型。
備註
要查看 Todoist API 後端服務的當前狀態、活動事件或即將進行的維護，請前往 Todoist 狀態頁面。
您現在已準備好開始使用此整合。
已知問題與限制
1. 連接
由於 Todoist OAuth 進程的限制：
- 當前記錄的 Todoist 帳戶將在創建連接時自動選擇使用。
- 標準方式不支持在現有連接的帳戶之間切換，因此如果您需要切換到另一個 Todoist 帳戶，請事先註銷 Todoist 門戶或使用瀏覽器隱身模式。
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 30 | 60 秒 |
| 觸發輪詢的頻率 | 1 | 15 秒 |
動作
| 依專案列出任務 （V4） |
列出特定專案中的所有任務。 |
| 依專案列出工作 [已淘汰] |
此動作已被取代。 請改用 按專案列出任務 （V4）。
|
| 依專案列出工作 （V2） [已淘汰] |
此動作已被取代。 請改用 按專案列出任務 （V4）。
|
| 依專案列出工作 （V3） [已淘汰] |
此動作已被取代。 請改用 按專案列出任務 （V4）。
|
| 共用專案 [已淘汰] |
此動作已被取代。 請改用共用專案 （V4）。
|
| 共用專案 （V2） [已淘汰] |
此動作已被取代。 請改用共用專案 （V4）。
|
| 共用專案 （V4） |
將現有專案共用給特定使用者。 |
| 列出專案 [已棄用] |
此動作已被取代。 請改用 List projects （V4）。
|
| 列出專案 （V2） [已淘汰] |
此動作已被取代。 請改用 List projects （V4）。
|
| 列出專案 （V3） [已淘汰] |
此動作已被取代。 請改用 List projects （V4）。
|
| 列出專案 （V4） |
列出 Todoist 帳戶中的所有項目。 |
| 列出工作 [已棄用] |
此動作已被取代。 請改用列出工作 （V4）。
|
| 列出工作 （V2） [已淘汰] |
此動作已被取代。 請改用列出工作 （V4）。
|
| 列出工作 （V3） [已淘汰] |
此動作已被取代。 請改用列出工作 （V4）。
|
| 列出工作 （V4） |
列出 Todoist 帳戶中的所有任務。 |
| 列出標籤 [已淘汰] |
此動作已被取代。 請改用清單標籤 （V4）。
|
| 列出標籤 （V3） [已淘汰] |
此動作已被取代。 請改用清單標籤 （V4）。
|
| 建立任務 （V4） |
在指定的專案中建立新任務。 |
| 建立專案 [已淘汰] |
此動作已被取代。 請改用建立專案 （V4）。
|
| 建立專案 （V2） [已淘汰] |
此動作已被取代。 請改用建立專案 （V4）。
|
| 建立專案 （V3） [已淘汰] |
此動作已被取代。 請改用建立專案 （V4）。
|
| 建立專案 （V4） |
建立新專案。 |
| 建立工作 [已棄用] |
此動作已被取代。 請改用建立工作 （V4）。
|
| 建立工作 （V2） [已棄用] |
此動作已被取代。 請改用建立工作 （V4）。
|
| 建立工作 （V3） [已淘汰] |
此動作已被取代。 請改用建立工作 （V4）。
|
| 建立標籤 [已棄用] |
此動作已被取代。 請改用 建立標籤 （V4）。
|
| 建立標籤 （V2） [已淘汰] |
此動作已被取代。 請改用 建立標籤 （V4）。
|
| 建立標籤 （V3） [已淘汰] |
此動作已被取代。 請改用 建立標籤 （V4）。
|
| 建立標籤 （V4） |
建立新標籤。 |
| 更新專案 [已淘汰] |
此動作已被取代。 請改用更新專案 （V4）。
|
| 更新專案 （V2） [已淘汰] |
此動作已被取代。 請改用更新專案 （V4）。
|
| 更新專案 （V3） [已淘汰] |
此動作已被取代。 請改用更新專案 （V4）。
|
| 更新專案 （V4） |
更新現有專案。 |
| 更新工作 [已棄用] |
此動作已被取代。 請改用更新工作 （V4）。
|
| 更新工作 （V2） [已淘汰] |
此動作已被取代。 請改用更新工作 （V4）。
|
| 更新工作 （V3） [已淘汰] |
此動作已被取代。 請改用更新工作 （V4）。
|
| 更新工作 （V4） |
更新現有任務。 |
| 更新標籤 [已棄用] |
此動作已被取代。 請改用更新標籤 （V4）。
|
| 更新標籤 （V2） [已淘汰] |
此動作已被取代。 請改用更新標籤 （V4）。
|
| 更新標籤 （V3） [已淘汰] |
此動作已被取代。 請改用更新標籤 （V4）。
|
| 更新標籤 （V4） |
更新現有標籤。 |
| 清單標籤 （V2） [已淘汰] |
此動作已被取代。 請改用清單標籤 （V4）。
|
| 清單標籤 （V4） |
列出 Todoist 帳戶中配置的標籤。 |
依專案列出任務 （V4）
列出特定專案中的所有任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
project_id | True | string |
專案的唯一識別碼。 |
傳回
- response
- array of TaskV2
依專案列出工作 [已淘汰]
此動作已被取代。 請改用 按專案列出任務 （V4）。
列出特定專案中的所有任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
id | True | string |
專案的唯一識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物品
|
items | array of Item |
項目集合 |
依專案列出工作 （V2） [已淘汰]
此動作已被取代。 請改用 按專案列出任務 （V4）。
列出特定專案中的所有任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
id | True | string |
專案的唯一識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物品
|
items | array of ItemV2 |
項目集合 |
依專案列出工作 （V3） [已淘汰]
此動作已被取代。 請改用 按專案列出任務 （V4）。
列出特定專案中的所有任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
project_id | True | integer |
專案的唯一識別碼。 |
傳回
- response
- array of Task
共用專案 [已淘汰]
此動作已被取代。 請改用共用專案 （V4）。
將現有專案共用給特定使用者。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
project_id | True | string |
專案的唯一識別碼。 |
|
Email
|
True | string |
專案共用對象使用者的電子郵件地址。 |
傳回
Todoist 專案物件
- 身體
- Project
共用專案 （V2） [已淘汰]
此動作已被取代。 請改用共用專案 （V4）。
將現有專案共用給特定使用者。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
project_id | True | string |
專案的唯一識別碼。 |
|
Email
|
True | string |
要與之共用專案的使用者電子郵件。 |
傳回
Todoist 專案物件
- 身體
- Project
共用專案 （V4）
將現有專案共用給特定使用者。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
project_id | True | string |
專案的唯一識別碼。 |
|
Email
|
True | string |
要與之共用專案的使用者電子郵件。 |
傳回
Todoist 專案物件
- 身體
- ProjectV4
列出專案 [已棄用]
此動作已被取代。 請改用 List projects （V4）。
列出 Todoist 帳戶中的所有項目。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
專案
|
projects | array of Project |
專案集合 |
列出專案 （V2） [已淘汰]
此動作已被取代。 請改用 List projects （V4）。
列出 Todoist 帳戶中的所有項目。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
專案
|
projects | array of Project |
專案集合 |
列出專案 （V3） [已淘汰]
列出專案 （V4）
列出工作 [已棄用]
列出工作 （V2） [已淘汰]
列出工作 （V3） [已淘汰]
列出工作 （V4）
列出標籤 [已淘汰]
此動作已被取代。 請改用清單標籤 （V4）。
列出 Todoist 帳戶中配置的標籤。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Labels
|
labels | array of Label |
標籤集合 |
列出標籤 （V3） [已淘汰]
建立任務 （V4）
在指定的專案中建立新任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Title
|
content | True | string |
工作的標題。 |
|
專案編號
|
project_id | string |
任務專案識別碼。如果未設定，工作會放入使用者的收件匣。 |
|
|
到期日
|
due_string | date-time |
任務截止日期（例如 2017-07-21T17：32：28Z）。 |
|
|
Priority
|
priority | integer |
介於 1 到 4 之間的數字（4 表示非常緊急，1 表示自然）。 |
|
|
父項識別碼
|
parent_id | string |
父任務的 ID。 將根任務設為 null |
|
|
子訂單
|
order | integer |
任務的順序。 定義任務在具有相同父 ID 的所有任務中的位置 |
傳回
Todoist 任務物件
- 身體
- TaskV2
建立專案 [已淘汰]
此動作已被取代。 請改用建立專案 （V4）。
建立新專案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
名稱
|
name | True | string |
項目的名稱。 |
|
顏色
|
color | string |
介於 0 到 11 之間的數字，對於高級用戶來說，介於 0 到 21 之間。 |
|
|
縮排
|
indent | string |
介於 1 到 4 之間的數字，其中 1 是頂層）。 |
|
|
訂單
|
item_order | string |
一個數字，其中最小值是頂層。 |
傳回
Todoist 專案物件
- 身體
- Project
建立專案 （V2） [已淘汰]
此動作已被取代。 請改用建立專案 （V4）。
建立新專案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
名稱
|
name | True | string |
項目的名稱。 |
|
顏色
|
color | integer |
顏色 ID。值介於 30 到 49 之間。 |
|
|
父項識別碼
|
parent_id | string |
父專案的 ID。 將根專案設為 null |
|
|
子訂單
|
child_order | integer |
專案的順序。 定義專案在具有相同父 ID 的所有專案中的位置 |
|
|
是最喜歡的
|
is_favorite | integer |
專案是否為我的最愛（其中 1 為真，0 為假）。 |
傳回
Todoist 專案物件
- 身體
- Project
建立專案 （V3） [已淘汰]
此動作已被取代。 請改用建立專案 （V4）。
建立新專案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
名稱
|
name | True | string |
項目的名稱。 |
|
顏色
|
color | integer |
顏色 ID。值介於 30 到 49 之間。 |
|
|
父項識別碼
|
parent_id | integer |
父專案的 ID。 將根專案設為 null |
|
|
是最喜歡的
|
favorite | boolean |
專案是否為我的最愛 （true 或 false 值）。 |
傳回
Todoist 專案物件
- 身體
- ProjectV3
建立專案 （V4）
建立新專案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
名稱
|
name | True | string |
項目的名稱。 |
|
顏色
|
color | string |
專案圖示的顏色。 |
|
|
父項識別碼
|
parent_id | string |
父專案的 ID。 將根專案設為 null |
|
|
是最喜歡的
|
is_favorite | boolean |
專案是否為我的最愛 （true 或 false 值）。 |
傳回
Todoist 專案物件
- 身體
- ProjectV4
建立工作 [已棄用]
此動作已被取代。 請改用建立工作 （V4）。
在指定的專案中建立新任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
project_id | True | string |
專案的唯一識別碼。 |
|
Title
|
content | True | string |
工作的標題。 |
|
到期日
|
date_string | date-time |
任務截止日期（例如 mm-dd-yyyy，今天 @ 上午 11 點，mm/dd/yyyy）。 |
|
|
Priority
|
priority | string |
介於 1 到 4 之間的數字（4 表示非常緊急，1 表示自然）。 |
|
|
縮排
|
indent | string |
介於 1 到 4 之間的數字，其中 1 是頂層）。 |
|
|
訂單
|
item_order | string |
一個數字，其中最小值是頂層。 |
傳回
Todoist 項目物件
- 身體
- Item
建立工作 （V2） [已棄用]
此動作已被取代。 請改用建立工作 （V4）。
在指定的專案中建立新任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
project_id | True | string |
專案的唯一識別碼。 |
|
Title
|
content | True | string |
工作的標題。 |
|
到期日
|
date_string | date-time |
任務截止日期（例如 2017-07-21T17：32：28Z）。 |
|
|
Priority
|
priority | string |
介於 1 到 4 之間的數字（4 表示非常緊急，1 表示自然）。 |
|
|
父項識別碼
|
parent_id | string |
父任務的 ID。 將根任務設為 null |
|
|
子訂單
|
child_order | integer |
任務的順序。 定義任務在具有相同父 ID 的所有任務中的位置 |
傳回
Todoist 項目物件
- 身體
- ItemV2
建立工作 （V3） [已淘汰]
此動作已被取代。 請改用建立工作 （V4）。
在指定的專案中建立新任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Title
|
content | True | string |
工作的標題。 |
|
專案編號
|
project_id | integer |
任務專案識別碼。如果未設定，工作會放入使用者的收件匣。 |
|
|
到期日
|
due_string | date-time |
任務截止日期（例如 2017-07-21T17：32：28Z）。 |
|
|
Priority
|
priority | string |
介於 1 到 4 之間的數字（4 表示非常緊急，1 表示自然）。 |
|
|
父項識別碼
|
parent_id | integer |
父任務的 ID。 將根任務設為 null |
|
|
子訂單
|
order | integer |
任務的順序。 定義任務在具有相同父 ID 的所有任務中的位置 |
傳回
Todoist 任務物件
- 身體
- Task
建立標籤 [已棄用]
此動作已被取代。 請改用 建立標籤 （V4）。
建立新標籤 （僅限進階使用者）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
名稱
|
name | True | string |
標籤的名稱。 |
|
顏色
|
color | string |
標籤的顏色（介於 0 到 7 之間的數字，高級用戶為 0 到 12）。 |
|
|
訂單
|
item_order | string |
標籤在標籤清單中的順序 （數字，其中最小值為頂層）。 |
傳回
Todoist 標籤物件
- 身體
- Label
建立標籤 （V2） [已淘汰]
此動作已被取代。 請改用 建立標籤 （V4）。
建立新標籤。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
名稱
|
name | True | string |
標籤的名稱。 |
|
顏色
|
color | string |
顏色 ID。值介於 30 到 49 之間。 |
|
|
訂單
|
item_order | string |
標籤在標籤清單中的順序 （一個數字，其中最小值應將標籤放在頂端）。 |
傳回
Todoist 標籤物件
- 身體
- LabelV2
建立標籤 （V3） [已淘汰]
此動作已被取代。 請改用 建立標籤 （V4）。
建立新標籤。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
名稱
|
name | True | string |
標籤的名稱。 |
|
顏色
|
color | integer |
顏色 ID。值介於 30 到 49 之間。 |
|
|
訂單
|
order | integer |
標籤在標籤清單中的順序 （一個數字，其中最小值應將標籤放在頂端）。 |
傳回
Todoist 標籤物件
- 身體
- LabelV3
建立標籤 （V4）
建立新標籤。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
名稱
|
name | True | string |
標籤的名稱。 |
|
顏色
|
color | string |
專案圖示的顏色。 |
|
|
訂單
|
order | integer |
標籤在標籤清單中的順序 （一個數字，其中最小值應將標籤放在頂端）。 |
傳回
Todoist 標籤物件
- 身體
- LabelV4
更新專案 [已淘汰]
此動作已被取代。 請改用更新專案 （V4）。
更新現有專案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
project_id | True | string |
專案的唯一識別碼。 |
|
名稱
|
name | string |
項目的名稱。 |
|
|
顏色
|
color | string |
介於 0 到 11 之間的數字，對於高級用戶來說，介於 0 到 21 之間。 |
|
|
縮排
|
indent | string |
介於 1 到 4 之間的數字，其中 1 是頂層）。 |
|
|
訂單
|
item_order | string |
一個數字，其中最小值是頂層。 |
傳回
Todoist 專案物件
- 身體
- Project
更新專案 （V2） [已淘汰]
此動作已被取代。 請改用更新專案 （V4）。
更新現有專案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
project_id | True | string |
專案的唯一識別碼。 |
|
名稱
|
name | True | string |
項目的名稱。 |
|
顏色
|
color | string |
顏色 ID。值介於 30 到 49 之間。 |
|
|
是最喜歡的
|
is_favorite | integer |
專案是否為我的最愛（其中 1 為真，0 為假）。 |
傳回
Todoist 專案物件
- 身體
- Project
更新專案 （V3） [已淘汰]
此動作已被取代。 請改用更新專案 （V4）。
更新現有專案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
id | True | integer |
專案的唯一識別碼。 |
|
名稱
|
name | True | string |
項目的名稱。 |
|
顏色
|
color | string |
顏色 ID。值介於 30 到 49 之間。 |
|
|
是最喜歡的
|
favorite | boolean |
專案是否為我的最愛 （true 或 false 值）。 |
更新專案 （V4）
更新現有專案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
id | True | string |
專案的唯一識別碼。 |
|
名稱
|
name | True | string |
項目的名稱。 |
|
顏色
|
color | string |
專案圖示的顏色。 |
|
|
是最喜歡的
|
is_favorite | boolean |
專案是否為我的最愛 （true 或 false 值）。 |
更新工作 [已棄用]
此動作已被取代。 請改用更新工作 （V4）。
更新現有任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
id | True | string |
專案的唯一識別碼。 |
|
任務標識符
|
item_id | True | string |
工作的唯一識別碼。 |
|
Title
|
content | string |
工作的標題。 |
|
|
Priority
|
priority | string |
數字介於 1 到 4 之間，4 表示非常緊急，1 表示自然。 |
|
|
縮排
|
indent | string |
介於 1 到 4 之間的數字，其中 1 是頂層）。 |
|
|
訂單
|
item_order | string |
一個數字，其中最小值是頂層。 |
傳回
Todoist 項目物件
- 身體
- Item
更新工作 （V2） [已淘汰]
此動作已被取代。 請改用更新工作 （V4）。
更新現有任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
id | True | string |
專案的唯一識別碼。 |
|
任務標識符
|
item_id | True | string |
工作的唯一識別碼。 |
|
Title
|
content | True | string |
工作的標題。 |
|
Priority
|
priority | string |
數字介於 1 到 4 之間，4 表示非常緊急，1 表示自然。 |
傳回
Todoist 項目物件
- 身體
- ItemV2
更新工作 （V3） [已淘汰]
此動作已被取代。 請改用更新工作 （V4）。
更新現有任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
project_id | True | integer |
專案的唯一識別碼。 |
|
任務標識符
|
id | True | string |
工作的唯一識別碼。 |
|
Title
|
content | True | string |
工作的標題。 |
|
Priority
|
priority | string |
數字介於 1 到 4 之間，4 表示非常緊急，1 表示自然。 |
更新工作 （V4）
更新現有任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
project_id | True | string |
專案的唯一識別碼。 |
|
任務標識符
|
id | True | string |
工作的唯一識別碼。 |
|
Title
|
content | True | string |
工作的標題。 |
|
Priority
|
priority | integer |
數字介於 1 到 4 之間，4 表示非常緊急，1 表示自然。 |
更新標籤 [已棄用]
此動作已被取代。 請改用更新標籤 （V4）。
更新現有標籤。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
標籤標識碼
|
label_id | True | string |
標籤的唯一識別碼。 |
|
名稱
|
name | string |
標籤的名稱。 |
|
|
顏色
|
color | string |
標籤的顏色（介於 0 到 7 之間的數字，高級用戶為 0 到 12）。 |
|
|
訂單
|
item_order | string |
標籤在標籤清單中的順序 （數字，其中最小值為頂層）。 |
傳回
Todoist 標籤物件
- 身體
- Label
更新標籤 （V2） [已淘汰]
此動作已被取代。 請改用更新標籤 （V4）。
更新現有標籤。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
標籤標識碼
|
label_id | True | string |
標籤的唯一識別碼。 |
|
名稱
|
name | string |
標籤的名稱。 |
|
|
顏色
|
color | string |
顏色 ID。值介於 30 到 49 之間。 |
|
|
訂單
|
item_order | string |
標籤清單中的標籤順序。 |
傳回
Todoist 標籤物件
- 身體
- LabelV2
更新標籤 （V3） [已淘汰]
此動作已被取代。 請改用更新標籤 （V4）。
更新現有標籤。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
標籤標識碼
|
id | True | string |
標籤的唯一識別碼。 |
|
名稱
|
name | string |
標籤的名稱。 |
|
|
顏色
|
color | integer |
顏色 ID。值介於 30 到 49 之間。 |
|
|
訂單
|
order | integer |
標籤清單中的標籤順序。 |
更新標籤 （V4）
更新現有標籤。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
標籤標識碼
|
id | True | string |
標籤的唯一識別碼。 |
|
名稱
|
name | string |
標籤的名稱。 |
|
|
顏色
|
color | string |
專案圖示的顏色。 |
|
|
訂單
|
order | integer |
標籤清單中的標籤順序。 |
清單標籤 （V2） [已淘汰]
此動作已被取代。 請改用清單標籤 （V4）。
列出 Todoist 帳戶中配置的標籤。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Labels
|
labels | array of LabelV2 |
標籤集合 |
清單標籤 （V4）
觸發程序
| 建立任務時 （V4） |
建立任務時，會觸發新的流程。 |
| 建立工作時 [已棄用] |
此動作已被取代。 請改用建立任務時 （V4）。
|
| 建立工作時 （V2） [已棄用] |
此動作已被取代。 請改用建立任務時 （V4）。
|
| 當任務完成時 [已淘汰] |
此動作已被取代。 請改用 When a task is completed （V4） 。
|
| 當任務完成時 （V2） [已淘汰] |
此動作已被取代。 請改用 When a task is completed （V4） 。
|
| 當任務完成時 （V4） |
在工作完成時觸發新流程 （僅限進階使用者）。 |
建立任務時 （V4）
建立任務時，會觸發新的流程。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
project_id | True | string |
專案的唯一識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物品
|
items | array of ItemV3 |
項目集合 |
建立工作時 [已棄用]
此動作已被取代。 請改用建立任務時 （V4）。
建立任務時，會觸發新的流程。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
project_id | True | string |
專案的唯一識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物品
|
items | array of Item |
項目集合 |
建立工作時 （V2） [已棄用]
此動作已被取代。 請改用建立任務時 （V4）。
建立任務時，會觸發新的流程。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
project_id | True | string |
專案的唯一識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物品
|
items | array of ItemV2 |
項目集合 |
當任務完成時 [已淘汰]
此動作已被取代。 請改用 When a task is completed （V4） 。
在任務完成時觸發新流程。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
project_id | True | string |
專案的唯一識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物品
|
items | array of Item |
項目集合 |
當任務完成時 （V2） [已淘汰]
此動作已被取代。 請改用 When a task is completed （V4） 。
在工作完成時觸發新流程 （僅限進階使用者）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
project_id | True | string |
專案的唯一識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
已完成的項目
|
items | array of CompletedItem |
已完成項目的集合 |
當任務完成時 （V4）
在工作完成時觸發新流程 （僅限進階使用者）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案編號
|
project_id | True | string |
專案的唯一識別碼。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
已完成的項目
|
items | array of CompletedItemV2 |
已完成項目的集合 |
定義
專案
Todoist 專案物件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
專案編號
|
id | string |
專案的唯一識別碼。 |
|
專案名稱
|
name | string |
項目的名稱。 |
|
顏色
|
color | integer |
專案的顏色。 |
|
專案是否共用
|
shared | boolean |
專案是否共用 |
|
專案是否已刪除
|
is_deleted | integer |
一個數字值（1 為 true，0 為 false），指示是否刪除專案。 |
|
項目是否已存檔
|
is_archived | integer |
一個數字值（1 為 true，0 為 false），指出專案是否已封存。 |
項目V3
Todoist 專案物件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
專案編號
|
id | integer |
專案的唯一識別碼。 |
|
專案名稱
|
name | string |
項目的名稱。 |
|
評論計數
|
comment_count | integer |
註解數。 |
|
訂單
|
order | integer |
相同父項下專案的順序。 |
|
顏色
|
color | integer |
專案的顏色。 |
|
專案是否共用
|
shared | boolean |
專案是否共用 |
|
同步識別碼
|
sync_id | integer |
識別碼，以尋找共用專案的不同副本之間的相符項。 |
|
是項目的最愛
|
favorite | boolean |
是項目的最愛 |
|
專案是否共用
|
inbox_project | boolean |
是專案收件匣 |
項目V4
Todoist 專案物件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
專案編號
|
id | string |
專案的唯一識別碼。 |
|
專案名稱
|
name | string |
項目的名稱。 |
|
父項識別碼
|
parent_id | string |
父專案的識別碼。 針對根專案設定為 null。 |
|
子訂單
|
child_order | integer |
相同父項下專案的順序。 |
|
顏色
|
color | string |
專案的顏色。 |
|
項目是否崩潰
|
collapsed | boolean |
是專案的子專案已摺疊。 |
|
專案是否共用
|
shared | boolean |
專案是否共用 |
|
專案是否標示為已刪除
|
is_deleted | boolean |
專案是否標示為已刪除 |
|
項目是否已存檔
|
is_archived | boolean |
項目是否已存檔 |
|
同步識別碼
|
sync_id | string |
識別碼，以尋找共用專案的不同副本之間的相符項。 |
|
是項目的最愛
|
is_favorite | boolean |
是項目的最愛 |
|
專案是否共用
|
inbox_project | boolean |
是專案收件匣 |
|
專案是否在小組收件匣中
|
team_inbox | boolean |
專案是否在小組收件匣中 |
|
檢視樣式
|
view_style | string |
這決定了項目在 Todoist 客戶端中的顯示方式。 |
項目
Todoist 項目物件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
工作標題
|
content | string |
工作的標題。 |
|
任務標識符
|
id | string |
任務的 ID。 |
|
任務擁有者
|
user_id | integer |
任務的擁有者。 |
|
專案編號
|
project_id | string |
任務所在的專案。 |
|
日期語言
|
date_lang | string |
日期的語言（有效語言為：en、da、pl、zh、ko、de、pt、ja、it、fr、sv、ru、es、nl）。 |
|
任務到期日
|
due_date_utc | date-time |
任務的日期格式為 Mon 07 Aug 2006 12：34：56 +0000。 |
|
縮排
|
indent | integer |
任務的縮排 （介於 1 到 4 之間的數字，其中 1 是最上層）。 |
|
任務優先順序
|
priority | integer |
任務的優先級（介於 1 到 4 之間的數字，4 表示非常緊急，1 表示自然）。 |
|
訂單
|
item_order | integer |
專案內任務的順序（最小值會將任務放在頂端）。 |
|
指派人識別碼
|
assigned_by_uid | integer |
指派目前任務的使用者識別碼。 僅適用於共享項目。 |
|
受指派人ID
|
responsible_uid | integer |
負責完成目前工作的使用者識別碼。 僅適用於共享項目。 |
|
IsTask已完成
|
checked | integer |
任務是否標示為已完成 （其中 1 為 true，0 為 false）。 |
|
IsTask已封存
|
is_archived | integer |
工作是否標示為已封存 （其中 1 為 true，0 為 false）。 |
|
建立日期
|
date_added | date-time |
建立任務的日期。 |
項目V2
Todoist 項目物件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
工作標題
|
content | string |
工作的標題。 |
|
任務標識符
|
id | string |
任務的 ID。 |
|
任務擁有者
|
user_id | integer |
任務的擁有者。 |
|
專案編號
|
project_id | string |
任務所在的專案。 |
|
日期語言
|
date_lang | string |
日期的語言（有效語言為：en、da、pl、zh、ko、de、pt、ja、it、fr、sv、ru、es、nl）。 |
|
任務到期日
|
due_date_utc | date-time |
工作日期，格式為 2006-08-07T16：34：56Z。 |
|
父項識別碼
|
parent_id | integer |
父任務的 ID。 將根任務設為 null |
|
子訂單
|
child_order | integer |
任務的順序。 定義任務在具有相同parent_id的所有任務中的位置 |
|
任務優先順序
|
priority | integer |
任務的優先級（介於 1 到 4 之間的數字，4 表示非常緊急，1 表示自然）。 |
|
指派人識別碼
|
assigned_by_uid | integer |
指派目前任務的使用者識別碼。 僅適用於共享項目。 |
|
受指派人ID
|
responsible_uid | integer |
負責完成目前工作的使用者識別碼。 僅適用於共享項目。 |
|
IsTask已完成
|
checked | integer |
任務是否標示為已完成 （其中 1 為 true，0 為 false）。 |
|
建立日期
|
date_added | date-time |
建立任務的日期。 |
項目V3
Todoist 項目物件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
工作標題
|
content | string |
工作的標題。 |
|
任務標識符
|
id | string |
任務的 ID。 |
|
任務擁有者
|
user_id | string |
任務的擁有者。 |
|
專案編號
|
project_id | string |
任務所在的專案。 |
|
Description
|
description | string |
任務的描述。 |
|
到期日
|
due.date | date-time |
截止日期。 |
|
Timezone
|
due.timezone | string |
Timezone |
|
繩子
|
due.string | string |
人類可讀的預產期表示。 String 一律代表使用者時區中的到期物件。 |
|
日期語言
|
due.lang | string |
日期的語言（有效語言為：en、da、pl、zh、ko、de、pt、ja、it、fr、sv、ru、es、nl）。 |
|
週期性日期
|
due.is_recurring | boolean |
布林旗標，如果到期物件代表週期性到期日，則設定為 true。 |
|
指派人識別碼
|
assigned_by_uid | string |
指派目前任務的使用者識別碼。 僅適用於共享項目。 |
|
受指派人ID
|
responsible_uid | string |
負責完成目前工作的使用者識別碼。 僅適用於共享項目。 |
|
任務是否已完成
|
checked | boolean |
任務是否標示為已完成 （其中 1 為 true，0 為 false）。 |
|
完成日期
|
completed_at | date-time |
任務完成的日期。 |
|
建立日期
|
added_at | date-time |
建立任務的日期。 |
|
父項識別碼
|
parent_id | string |
父任務的 ID。 將根任務設為 null |
|
子訂單
|
child_order | integer |
任務的順序。 定義任務在具有相同parent_id的所有任務中的位置 |
|
任務優先順序
|
priority | integer |
任務的優先級（介於 1 到 4 之間的數字，4 表示非常緊急，1 表示自然）。 |
|
區段 ID
|
section_id | string |
父區段的識別碼。 |
|
倒塌
|
collapsed | boolean |
任務的子任務是否折疊（其中 1 為 true，0 為 false）。 |
|
Labels
|
labels | array of string |
任務的標籤 |
|
創作者 ID
|
added_by_uid | string |
建立任務的使用者 ID。 僅適用於共享項目。 |
|
總數
|
duration.amount | integer |
任務將花費的時間量。 |
|
單位
|
duration.unit | string |
金額所代表的時間單位。 |
任務
Todoist 任務物件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
任務標識符
|
id | integer |
任務的 ID。 |
|
任務是否已完成
|
completed | boolean |
任務是否完成 |
|
專案編號
|
project_id | integer |
任務所在的專案。 |
|
區段 ID
|
section_id | integer |
區段任務所屬的 ID。 |
|
父項識別碼
|
parent_id | integer |
父任務的 ID。 針對根工作設定為 null。 |
|
任務內容
|
content | string |
任務內容。 |
|
評論數
|
comment_count | integer |
任務註解數 |
|
訂單
|
order | integer |
任務的順序。 定義任務在具有相同parent_id的所有任務中的位置 |
|
任務優先順序
|
priority | integer |
任務的優先級（介於 1 到 4 之間的數字，4 表示非常緊急，1 表示自然）。 |
|
工作網址
|
url | string |
在 Todoist Web 界面中訪問此任務的 URL。 |
任務V2
Todoist 任務物件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
任務標識符
|
id | string |
任務的 ID。 |
|
任務是否已完成
|
is_completed | boolean |
任務是否完成 |
|
專案編號
|
project_id | string |
任務所在的專案。 |
|
區段 ID
|
section_id | string |
區段任務所屬的 ID。 |
|
父項識別碼
|
parent_id | string |
父任務的 ID。 針對根工作設定為 null。 |
|
任務內容
|
content | string |
任務內容。 |
|
評論數
|
comment_count | integer |
任務註解數 |
|
訂單
|
order | integer |
任務的順序。 定義任務在具有相同parent_id的所有任務中的位置 |
|
任務優先順序
|
priority | integer |
任務的優先級（介於 1 到 4 之間的數字，4 表示非常緊急，1 表示自然）。 |
|
工作網址
|
url | string |
在 Todoist Web 界面中訪問此任務的 URL。 |
|
Description
|
description | string |
任務的描述。 |
|
到期日
|
due.date | date-time |
截止日期。 |
|
Timezone
|
due.timezone | string |
Timezone |
|
繩子
|
due.string | string |
人類可讀的預產期表示。 String 一律代表使用者時區中的到期物件。 |
|
日期時間
|
due.datetime | date-time |
只有在設定了確切的到期時間時才會傳回。 |
|
週期性日期
|
due.is_recurring | boolean |
布林旗標，如果到期物件代表週期性到期日，則設定為 true。 |
|
創作者 ID
|
creator_id | string |
建立任務的使用者 ID。 針對根工作設定為 null。 |
|
受指派人ID
|
assignee_id | string |
負責的使用者 ID。 針對根工作設定為 null。 |
|
指派人識別碼
|
assigner_id | string |
指派任務的使用者 ID。 針對根工作設定為 null。 |
|
總數
|
duration.amount | integer |
任務將花費的時間量。 |
|
單位
|
duration.unit | string |
金額所代表的時間單位。 |
已完成項目
Todoist 已完成的任務物件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
工作項目標識符
|
id | string |
已完成工作項目的 ID。 |
|
任務標識符
|
task_id | integer |
已完成任務的 ID。 |
|
任務擁有者
|
user_id | integer |
任務的擁有者。 |
|
專案編號
|
project_id | string |
任務所在的專案。 |
|
工作標題
|
content | string |
工作的標題。 |
|
完成日期
|
completed_date | date-time |
任務完成的日期。 |
|
音符計數
|
note_count | integer |
任務的筆記數。 |
|
詳細資訊
|
meta_data | string |
可選的額外細節。 |
已完成項目V2
Todoist 已完成的任務物件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
工作項目標識符
|
id | string |
已完成工作項目的 ID。 |
|
任務標識符
|
task_id | string |
已完成任務的 ID。 |
|
任務擁有者
|
user_id | string |
任務的擁有者。 |
|
專案編號
|
project_id | string |
任務所在的專案。 |
|
專案編號
|
section_id | string |
任務所在的專案。 |
|
工作標題
|
content | string |
工作的標題。 |
|
完成日期
|
completed_at | date-time |
任務完成的日期。 |
|
音符計數
|
note_count | integer |
任務的筆記數。 |
|
詳細資訊
|
meta_data | string |
可選的額外細節。 |
|
dynamicProperties （動態屬性）
|
item_object.dynamicProperties | object |
標籤
Todoist 標籤物件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
標籤標識碼
|
id | integer |
標籤的識別碼。 |
|
標籤名稱
|
name | string |
標籤的名稱。 |
|
顏色
|
color | integer |
標籤的顏色（介於 0 到 7 之間的數字，對於高級用戶來說，介於 0 和 12 之間）。 |
|
訂單
|
item_order | integer |
標籤在標籤清單中的順序 （數字，其中最小值為頂層）。 |
|
已刪除
|
is_deleted | integer |
標籤是否標示為已刪除 （其中 1 為 true，0 為 false）。 |
標籤V2
Todoist 標籤物件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
標籤標識碼
|
id | integer |
標籤的識別碼。 |
|
標籤名稱
|
name | string |
標籤的名稱。 |
|
顏色
|
color | integer |
顏色 ID。這是一個介於 30 到 49 之間的值，更多信息 - https://developer.todoist.com/sync/v8/#colors |
|
訂單
|
item_order | integer |
標籤在標籤清單中的順序 （一個數字，其中最小值應將標籤放在頂端）。 |
|
已刪除
|
is_deleted | integer |
標籤是否標示為已刪除 （其中 1 為 true，0 為 false）。 |
|
是最愛
|
is_favorite | integer |
標籤是否為我的最愛 （其中 1 為 true，0 為 false）。 |
標籤V3
Todoist 標籤物件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
標籤標識碼
|
id | integer |
標籤的識別碼。 |
|
標籤名稱
|
name | string |
標籤的名稱。 |
|
顏色
|
color | integer |
顏色 ID。這是一個介於 30 到 49 之間的值，更多信息 - https://developer.todoist.com/sync/v8/#colors |
|
訂單
|
order | integer |
標籤在標籤清單中的順序 （一個數字，其中最小值應將標籤放在頂端）。 |
|
是最愛
|
favorite | boolean |
標籤是否為我的最愛 （true 或 false 值）。 |
標籤V4
Todoist 標籤物件
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
標籤標識碼
|
id | string |
標籤的識別碼。 |
|
標籤名稱
|
name | string |
標籤的名稱。 |
|
顏色
|
color | string |
標籤圖示的顏色。 如需詳細資訊，請參閱顏色指南中的名稱欄。 |
|
項目順序
|
item_order | integer |
標籤在標籤清單中的順序 （一個數字，其中最小值應將標籤放在頂端）。 |
|
已刪除
|
is_deleted | boolean |
標籤是否標示為已刪除 （true 或 false 值）。 |
|
是最愛
|
is_favorite | boolean |
標籤是否為我的最愛 （true 或 false 值）。 |