Organizations

組織のリスト表示

GET /api/v1/organizations

認証されたユーザーが属するすべての組織を返します。

レスポンス

{
  "data": [
    {
      "id": "org_uuid",
      "name": "Acme Inc.",
      "role": "ADMIN",
      "member_count": 12
    }
  ]
}

ロールの値

ロール	説明
OWNER	完全なアクセス権、組織の移管または削除が可能
ADMIN	メンバー、フォルダー、およびすべての録画を管理
EDITOR	自分の録画を作成および管理
VIEWER	読み取り専用アクセス

---

フォルダーのリスト表示

GET /api/v1/organizations/:id/folders

組織内のすべてのアクティブなフォルダーを返します。認証されたユーザーはメンバーである必要があります。

レスポンス

{
  "data": [
    {
      "id": "folder_uuid",
      "name": "Product team"
    }
  ]
}

---

メンバーのリスト表示

GET /api/v1/organizations/:id/members

組織のすべてのメンバーを返します。認証されたユーザーはメンバーである必要があります。

レスポンス

{
  "data": [
    {
      "id": "user_uuid",
      "email": "alice@example.com",
      "name": "Alice",
      "role": "EDITOR"
    }
  ]
}

エラーコード

コード	HTTP ステータス	意味
FORBIDDEN	403	ユーザーはこの組織のメンバーではありません
ORGANIZATION_NOT_FOUND	404	組織が存在しません