API エンドポイント

すべての TeamDay API エンドポイントの完全なリファレンス。すべてのエンドポイントには Personal Access Token を使用した認証が必要です。

ベース URL

https://cc.teamday.ai/api/v1

認証

すべてのリクエストは、Authorization ヘッダーに Personal Access Token を含める必要があります：

Authorization: Bearer td_your-token-here

エージェント

組織内の AI エージェント (キャラクター) を管理します。

エージェントをリスト表示

アカウントがアクセスできるすべてのエージェントを取得します。

GET /api/v1/agents

レスポンス:

{
  "agents": [
    {
      "id": "char_abc123",
      "name": "Code Reviewer",
      "role": "Senior Developer",
      "systemPrompt": "You review code for quality...",
      "visibility": "private",
      "model": "claude-3-5-sonnet-20241022",
      "createdAt": "2024-12-09T10:00:00Z"
    }
  ]
}

エージェントを作成

新しい AI エージェントを作成します。

POST /api/v1/agents

リクエスト本文:

{
  "name": "Research Assistant",
  "role": "Researcher",
  "systemPrompt": "You are a helpful research assistant.",
  "visibility": "organization",
  "model": "claude-3-5-sonnet-20241022"
}

エージェントを実行

メッセージを処理するためにエージェントを実行します。

POST /api/v1/agents/{agentId}/execute

リクエスト本文:

{
  "message": "Analyze this repository",
  "spaceId": "space_abc123",
  "stream": false
}

タスク

エージェント間の調整作業を作成および管理します。

タスクをリスト表示

GET /api/v1/tasks

タスクを作成

POST /api/v1/tasks

リクエスト本文:

{
  "title": "Deploy to production",
  "priority": "high",
  "assignedTo": "char_deploy_bot"
}

実行

エージェント実行履歴を追跡します。

実行をリスト表示

GET /api/v1/executions?agentId={agentId}

実行の詳細を取得

GET /api/v1/executions/{executionId}

スペース

ワークスペース環境を管理します。

ファイルを参照

GET /api/spaces/{spaceId}/files/browse?path={path}

ファイルを読み取り

GET /api/spaces/{spaceId}/files/read?path={path}

ファイルに書き込み

POST /api/spaces/{spaceId}/files/write

エラーレスポンス

{
  "error": true,
  "statusCode": 400,
  "message": "Validation error"
}

完全なエンドポイントの詳細、例、パラメータについては、インタラクティブな API ドキュメント を参照してください。