Tasks API

タスクはエージェントまたはユーザーに割り当てることができる作業項目を表します。Tasks API を使用してワークフローを管理し、進捗を追跡し、組織全体で作業を調整します。

ベース URL: https://us.teamday.ai/api/v1/tasks

認証: Personal Access Token 必須

---

エンドポイント概要

メソッド	エンドポイント	説明	状態
GET	/tasks	タスクをリスト表示	🟡 テスト未了
POST	/tasks	新しいタスクを作成	🟡 テスト未了

実装状況: 完了したがテスト未了

---

タスクオブジェクト

プロパティ

{
  id: string              // タスク ID (形式: task_xxx)
  title: string           // タスクタイトル
  description: string     // 詳細な説明
  status: string          // "pending" | "in_progress" | "completed" | "cancelled"
  priority: string        // "low" | "medium" | "high" | "urgent"
  assignedTo?: string     // エージェントまたはユーザー ID
  assigneeType: string    // "agent" | "user"
  spaceId?: string        // 関連するワークスペース
  organizationId: string  // 所有組織
  createdBy: string       // 作成者ユーザー ID
  createdAt: string       // ISO 8601 タイムスタンプ
  updatedAt: string       // ISO 8601 タイムスタンプ
  dueDate?: string        // ISO 8601 タイムスタンプ
  completedAt?: string    // ISO 8601 タイムスタンプ
  metadata: object        // 追加タスクコンテキスト
}

オブジェクト例

{
  "id": "task_abc123",
  "title": "Analyze Q4 sales data",
  "description": "Review Q4 sales performance and identify trends",
  "status": "in_progress",
  "priority": "high",
  "assignedTo": "agent_xyz789",
  "assigneeType": "agent",
  "spaceId": "space_456",
  "organizationId": "org_123",
  "createdBy": "user_789",
  "createdAt": "2025-12-09T09:00:00Z",
  "updatedAt": "2025-12-09T10:30:00Z",
  "dueDate": "2025-12-10T17:00:00Z",
  "metadata": {
    "tags": ["sales", "analytics", "quarterly"],
    "source": "api"
  }
}

---

タスクをリスト表示

オプションのフィルタリング付きで、組織のタスクを取得します。

リクエスト

GET /api/v1/tasks

ヘッダー:

Authorization: Bearer td_xxxxx...

クエリパラメータ:

• status (string, optional) - ステータスでフィルタ: pending、in_progress、completed、cancelled
• assignedTo (string, optional) - エージェントまたはユーザー ID でフィルタ
• spaceId (string, optional) - ワークスペースでフィルタ
• priority (string, optional) - 優先度でフィルタ: low、medium、high、urgent
• limit (number, optional) - 最大結果数 (デフォルト: 50、最大: 100)

詳細については、API ドキュメント を参照してください。