콘텐츠로 이동

조직

소속된 조직에 대한 읽기 전용 엔드포인트입니다. 모든 경로는 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 상태의미
FORBIDDEN403이 조직의 멤버가 아닙니다