Task API

Task API では、タスクやタスクカテゴリーの投稿を管理することができます。
Tas API は、User Account 認証で発行された Access Token でのみ呼び出すことができます。Service Account 認証 (JWT) で発行された Access Token では呼び出すことができません。

Scopes: task, task.read

タスクの管理 {#manage-task}

タスクの取得・登録・更新は、以下の API を利用します。マイタスクのタスクカテゴリーを移動することもできます。

HTTP RequestDescription
POST /users/{userId}/tasksユーザーのマイタスク登録
GET /users/{userId}/tasksユーザーのマイタスクのリスト取得
GET /tasks/{taskId}タスクの取得
PATCH /tasks/{taskId}タスクの部分更新
DELETE /tasks/{taskId}タスクの削除
POST /users/{userId}/tasks/{taskId}/moveマイタスクのカテゴリー移動

タスクの完了・完了取り消しには、以下の API を利用します。

HTTP RequestDescription
POST /tasks/{taskId}/completeタスクの完了
POST /tasks/{taskId}/incompleteタスクの完了取り消し
POST /tasks/{taskId}/assignees/{userId}/complete自分のタスクの完了
POST /tasks/{taskId}/assignees/{userId}/incomplete自分のタスクの完了取り消し

タスクカテゴリーの管理 {#manage-taskcategory}

タスクカテゴリーの管理には、以下の API を利用します。

HTTP RequestDescription
POST /users/{userId}/task-categoriesユーザーのタスクカテゴリー登録
GET /users/{userId}/task-categoriesユーザーのタスクカテゴリーリスト取得
GET /users/{userId}/task-categories/{categoryId}ユーザーのタスクカテゴリー取得
PATCH /users/{userId}/task-categories/{categoryId}ユーザーのタスクカテゴリー部分更新
DELETE /users/{userId}/task-categories/{categoryId}ユーザーのタスクカテゴリー削除