プロジェクトのタスク一覧

GET/api/project/{projectId}/task

プロジェクトのタスクをページ送りで返します。parent_id にタスク ID を指定するとサブタスク一覧、root を指定すると最上位のタスクだけになります。parent_id 指定時は木の並び順 (sortOrder)、省略時は ID 順です。カンマ区切りの ID 絞り込みは、いずれかに一致するものを返します。

パラメーター

projectIdintegerpath必須: プロジェクトの ID です。
pageintegerquery: ページ番号 (1 から)
limitintegerquery: 1 ページの件数 (500 件まで)
parent_id"root" | integerquery: タスク ID を渡すとそのサブタスクだけ、root を渡すと最上位のタスクだけを返します。省略するとプロジェクトのすべてのタスクを返します。
closedtrue | falsequery: true で完了したタスクだけ、false で未完了のタスクだけを返します。省略するとどちらも返します。
status_idsstringquery: ステータス ID のカンマ区切りです。いずれかのステータスのタスクを返します。
milestone_idsstringquery: マイルストーン ID のカンマ区切りです。いずれかのマイルストーンのタスクを返します。
tag_idsstringquery: タグ ID のカンマ区切りです。いずれかのタグが付いたタスクを返します。
responsible_user_idsstringquery: ユーザー ID のカンマ区切りです。いずれかのユーザーが担当のタスクを返します。
ball_holder_idsstringquery: ユーザー ID のカンマ区切りです。いずれかのユーザーがボールを持っているタスクを返します。

レスポンス

200{ tasks, page, limit, hasMore }
400Invalid query parameters
401Authentication is required
403Not a project member
404Project not found

{ "tasks": [ { "id": 100442, "parentId": null, "projectId": 296, "responsibleUserId": 1127, "ballHoldingUserId": 1127, "statusId": 196, "milestoneId": 38, "sortOrder": null, "statusBoardSortOrder": null, "priorityBoardSortOrder": null, "responsibleUserBoardSortOrder": null, "ballHoldingUserBoardSortOrder": null, "milestoneBoardSortOrder": null, "name": "Write release notes for v2.0", "planned": null, "actual": null, "priority": 2, "extra": null, "startDate": 1794182400000, "dueDate": 1794614400000, "createdAt": 1793662651065, "updatedAt": 1793662651113, "deletedAt": null, "tagIds": [ 90 ], "description": "Summarize the changes in the new website for the **launch announcement**." } ], "page": 1, "limit": 20, "hasMore": false }