組織
所属している組織を対象とした読み取り専用のエンドポイントです。すべてのパスは https://api.recordmeeting.com 上にあり、API キーが必要です。認証 を参照してください。
組織の録画を一覧表示するには、organization_id を指定して 録画一覧 を使用します。
組織の一覧表示
Section titled “組織の一覧表示”GET /v1/organizations所属しているすべての組織を返します。
{ "data": [ { "id": "org_uuid", "name": "Acme Inc.", "role": "ADMIN", "member_count": 12 } ]}| ロール | 説明 |
|---|---|
OWNER | 組織に対する完全な権限 |
ADMIN | 設定、メンバー、フォルダを管理 |
EDITOR | 録画の作成、編集、閲覧が可能 |
VIEWER | 閲覧のみ可能 |
フォルダの一覧表示
Section titled “フォルダの一覧表示”GET /v1/organizations/:id/folders組織の有効なフォルダを返します。組織のメンバーである必要があります。
{ "data": [ { "id": "folder_uuid", "name": "Product team", "icon": null } ]}icon はフォルダのアイコン名、または null です。
メンバーの一覧表示
Section titled “メンバーの一覧表示”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 になります。
エラーコード
Section titled “エラーコード”| コード | HTTP ステータス | 意味 |
|---|---|---|
FORBIDDEN | 403 | この組織のメンバーではありません |