プロジェクト
プロジェクトとプロジェクトメンバーを管理します。
プロジェクト系エンドポイントはワークスペースのコンテキストを要求します。対応する API リクエストで workspaceId を渡すか、ワークスペース単位のトークンを使います。
プロジェクト
| メソッド | パス | 用途 |
|---|---|---|
| GET | /v1/projects |
選択中のワークスペースで見えるプロジェクトを一覧 |
| POST | /v1/projects |
プロジェクトを作成 |
| PATCH | /v1/projects/:projectId |
プロジェクトを更新 |
| DELETE | /v1/projects/:projectId |
プロジェクトを削除 |
プロジェクトは非公開のパック / トラックの scope: { "type": "projects", "ids": [...] } に使えます。
プロジェクトの name は必須です。description は Markdown の内容を受け取ります。更新は PATCH 方式なので、省略した項目は維持されます。
プロジェクトメンバー
| メソッド | パス | 用途 |
|---|---|---|
| POST | /v1/projects/members/list |
複数プロジェクトにまたがるメンバーを一覧 |
| PUT | /v1/projects/:projectId/members |
プロジェクトメンバーを追加 |
| DELETE | /v1/projects/:projectId/members |
プロジェクトメンバーを一括削除 |
| DELETE | /v1/projects/:projectId/members/:userId |
プロジェクトメンバー1人を削除 |
POST /v1/projects/members/list は { "projectIds": [...] } を受け取ります。
PUT /v1/projects/:projectId/members は従来の1人追加 body と一括追加 body の両方を受け取ります。
{ "userId": "user-id" }{ "userIds": ["user-id-1", "user-id-2"] }一括削除は request body ではなく、カンマ区切りの userIds クエリパラメータを使います。DELETE の body は一部の中継環境で落とされることがあるためです。
DELETE /v1/projects/:projectId/members?userIds=user-id-1,user-id-2
Authorization: Bearer <token>プロジェクトメンバーの一括操作は1リクエストあたり最大100ユーザー ID までです。