조직
소속된 조직에 대한 읽기 전용 엔드포인트입니다. 모든 경로는 https://api.recordmeeting.com에 있으며 API 키가 필요합니다. 인증을 참고하세요.
조직의 녹음을 나열하려면 organization_id와 함께 녹음 목록을 사용하세요.
조직 목록
섹션 제목: “조직 목록”GET /v1/organizations소속된 모든 조직을 반환합니다.
{ "data": [ { "id": "org_uuid", "name": "Acme Inc.", "role": "ADMIN", "member_count": 12 } ]}역할 값
섹션 제목: “역할 값”| 역할 | 설명 |
|---|---|
OWNER | 조직에 대한 모든 권한 |
ADMIN | 설정, 멤버, 폴더를 관리 |
EDITOR | 녹음을 생성, 편집, 조회 |
VIEWER | 조회 전용 권한 |
폴더 목록
섹션 제목: “폴더 목록”GET /v1/organizations/:id/folders조직의 활성 폴더를 반환합니다. 조직의 멤버여야 합니다.
{ "data": [ { "id": "folder_uuid", "name": "Product team", "icon": null } ]}icon은 폴더 아이콘의 이름이며, 없으면 null입니다.
멤버 목록
섹션 제목: “멤버 목록”GET /v1/organizations/:id/members조직의 멤버를 반환합니다. 조직의 멤버여야 합니다.
{ "data": [ { "id": "user_uuid", "email": "alice@example.com", "name": "Alice", "role": "EDITOR" } ], "emails_included": true}이메일 주소는 조직에서의 역할이 OWNER 또는 ADMIN일 때만 반환됩니다. 다른 역할의 경우 모든 email이 null이고 emails_included가 false입니다.
오류 코드
섹션 제목: “오류 코드”| 코드 | HTTP 상태 | 의미 |
|---|---|---|
FORBIDDEN | 403 | 이 조직의 멤버가 아닙니다 |