トラック

タスク/ゴールの作成 / 更新 / 検索 / 削除/一括適用です。

進行中の作業はトラックエンドポイントで扱います。

タスクの作成

POST /v1/tracks
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "type": "task",
  "title": "Review docs",
  "scope": { "type": "personal" },
  "task": { "status": "todo", "dueDate": "2026-06-05" }
}

ゴールの作成

{
	"type": "goal",
	"title": "Ship documentation v1",
	"scope": { "type": "projects", "ids": ["project-id"] },
	"goal": { "status": "on_track", "progress": 40 }
}

検索

タスク絞り込みには status, assignee, goalId, parentId, dependsOn、日付範囲、doneAt の範囲があります。ゴール絞り込みには status, progressMin, progressMax、日付範囲があります。

type が task の場合、progressMin や progressMax のようなゴール専用の絞り込みは不正です。type が goal の場合、assignee, goalId, parentId, dependsOn, doneAtFrom / doneAtTo のようなタスク専用の絞り込みは不正です。

操作	コスト
`tracks.search`	2 credits
`tracks.get`	1 credit
`tracks.review`	AI token usage
`tracks.apply`	1 credit
`tracks.create/update/delete`	1 credit

検索結果で対象を絞ってから、必要なトラックだけ個別に取得してください。

一括適用

{
	"scope": { "type": "personal" },
	"upserts": [
		{ "id": "t001", "title": "Task A", "task": { "status": "todo" } },
		{ "id": "t002", "title": "Task B", "task": { "status": "todo", "dependsOn": ["t001"] } }
	]
}

非 UUID の id は新規作成、UUID の id は既存更新です。

upserts では task または goal から種別を推論します。両方を渡すと不正です。新規トラックには title が必要です。UUID の id は省略項目を維持します。

レビュー

POST /v1/tracks/review
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "targetIds": ["task-or-goal-id"],
  "instruction": "source workflow pack に反映すべき点を重視してください。"
}

1件以上のタスクまたはゴールに対する読み取り専用のレビューを生成します。レスポンスには targets と review が含まれ、詳細レビューでは review の中に stats と生成された Markdown content が返されます。

{
	"targets": [{ "id": "task-or-goal-id", "title": "Review docs", "entityType": "task" }],
	"review": {
		"stats": {
			"relatedTaskCount": 4,
			"doneTaskCount": 2,
			"logCount": 5,
			"sourceCount": 2
		},
		"content": "## Summary\n..."
	}
}

詳細レビューは AI token usage に基づいてクレジットを消費します。トラックのステータス更新時に返る軽量な review stats は無料です。

トラックへの活動/コメントログの追加・一覧(1トラックまたは全トラック横断)・削除についてはログを参照してください。