조직

조직 목록

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	조직이 존재하지 않습니다