プロジェクトAPI

プロジェクトの作成・取得・更新を行うAPIエンドポイントです。

GET /api/v1/projects

所属する組織のプロジェクト一覧を取得します。

// レスポンス
{
  "data": [
    {
      "id": "prj_abc123",
      "name": "作品A 第1期",
      "status": "active",
      "episode_count": 12,
      "created_at": "2026-01-15T00:00:00Z"
    }
  ],
  "pagination": {
    "cursor": "prj_abc123",
    "has_more": true
  }
}

POST /api/v1/projects

新しいプロジェクトを作成します。OWNER / ADMIN権限が必要です。

// リクエスト
{
  "name": "作品B 第2期",
  "description": "全13話構成",
  "template_id": "tpl_standard"
}

// レスポンス (201 Created)
{
  "id": "prj_def456",
  "name": "作品B 第2期",
  "status": "active",
  "created_at": "2026-03-22T10:00:00Z"
}

PATCH /api/v1/projects/[id]

プロジェクト情報を更新します。

// リクエスト
{
  "name": "作品B 第2期（改）",
  "status": "archived"
}

// レスポンス (200 OK)
{
  "id": "prj_def456",
  "name": "作品B 第2期（改）",
  "status": "archived",
  "updated_at": "2026-03-22T12:00:00Z"
}