録画
録画、トランスクリプト、共有リンク用のエンドポイントです。すべてのパスは https://api.recordmeeting.com 上にあり、APIキーが必要です。認証を参照してください。
録画の一覧取得
Section titled “録画の一覧取得”GET /v1/recordingsアクセスできる録画のページ分けされた一覧を返します。
クエリパラメーター
Section titled “クエリパラメーター”| パラメーター | 種類 | 既定値 | 説明 |
|---|---|---|---|
limit | integer | 20 | 結果の件数 (1から100) |
offset | integer | 0 | ページネーションのオフセット |
search | string | none | タイトル内のテキストで絞り込みます |
status | string | none | ステータスで絞り込みます (録画のステータスを参照してください) |
date_from | string | none | ISO 8601形式の日付と時刻。この日時以降に作成された録画のみ |
date_to | string | none | ISO 8601形式の日付と時刻。この日時以前に作成された録画のみ |
organization_id | string | none | 組織の録画を一覧表示します |
folder_id | string | none | フォルダーの録画を一覧表示します |
user_id | string | none | ユーザーで絞り込みます。1人のメンバーの録画を取得したい組織の管理者向けです |
{ "data": [ { "id": "uuid", "title": "Weekly sync", "status": "COMPLETED", "created_at": "2026-09-19T15:00:00.000Z", "duration_seconds": 1740, "thumbnail_url": "https://...", "folder_id": null, "organization_id": null, "transcription_status": "completed", "notes_status": "completed", "is_shared": true, "processing_progress": null } ], "pagination": { "total": 42, "limit": 20, "offset": 0, "has_more": true }}title、duration_seconds、thumbnail_url、folder_id、organization_id、transcription_status、notes_status、processing_progressはnullになる場合があります。ロックされた録画では、transcription_statusとnotes_statusはnullです。
organization_idを指定した場合、EditorとViewerは表示が許可された録画のみを取得します。その場合、totalは上限値であり、1ページにlimit件より少ない項目が含まれることがあります。
エラー: その組織の録画を一覧表示できない場合、400 VALIDATION_ERROR、403 FORBIDDEN。
GET /v1/recordings/:id1件の録画の完全な詳細を返します。
組織の録画は、表示できるすべてのメンバーに返されます。OwnerとAdminは、組織内のすべての録画を開くことができます。EditorとViewerは、役割とフォルダーで許可された内容を表示します。組織の録画では、is_locked、download_url、capabilitiesは個人のプランではなく、組織のプランとメンバーの機能アクセスに従います。
{ "data": { "id": "uuid", "title": "Weekly sync", "status": "COMPLETED", "created_at": "2026-09-19T15:00:00.000Z", "updated_at": "2026-09-19T15:30:00.000Z", "started_at": "2026-09-19T15:01:00.000Z", "ended_at": "2026-09-19T15:30:00.000Z", "duration_seconds": 1740, "thumbnail_url": "https://...", "download_url": "https://...", "download_url_expires_at": "2026-09-19T21:30:00.000Z", "folder_id": null, "organization_id": null, "processing_progress": null, "transcription": { "status": "completed", "language": "en", "speakers": ["Alice", "Bob"], "segments_count": 184 }, "notes": "## Key topics\n...", "notes_status": "completed", "notes_truncated": false, "sharing": { "is_shared": true, "share_url": "https://recordmeeting.com/app/shared/abc123" }, "participants": [ { "id": "participant_id", "displayName": "Alice", "email": "alice@example.com", "source": "calendar", "isOrganizer": true, "mappedSpeaker": "Alice", "avatarUrl": null } ], "media_type": "video", "is_locked": false, "open_url": "https://recordmeeting.com/app/recording/uuid", "media": { "hls_url": "https://...", "direct_url": "https://...", "expires_at": "2026-09-19T21:30:00.000Z" }, "capabilities": { "canDownload": true, "canShare": true, "canViewTranscription": true, "canStartTranscription": true, "canRegenerateTranscription": false, "canRenameSpeaker": true, "canReplaceText": true, "canViewSummary": true, "canGenerateSummary": true, "canAskQuestions": true, "canGenerateArtifacts": true } }}知っておくべきフィールド
Section titled “知っておくべきフィールド”| フィールド | 説明 |
|---|---|
notes | Markdown形式の会議メモ。メモがない場合や録画がロックされている場合はnull |
download_url | 一時的なダウンロードリンク。capabilities.canDownloadがtrueの場合を除きnull。download_url_expires_atに有効期限が切れます |
media | 一時的な再生リンク。expires_atを過ぎたら録画を再度リクエストしてください |
media_type | videoまたはaudio |
is_locked | 録画がロックされている場合はtrue。その場合、transcriptionとnotesはnullです |
open_url | Webアプリ内の録画ページ |
sharing.share_url | 録画の共有リンク。ない場合はnull |
エラー: 404 RECORDING_NOT_FOUND、組織のEnterpriseサブスクリプションが有効でなくなった場合402 ORGANIZATION_SUBSCRIPTION_EXPIRED。
トランスクリプトの取得
Section titled “トランスクリプトの取得”GET /v1/recordings/:id/transcript録画のトランスクリプトをチャンク単位のページでセグメントとして返します。
組織の録画には録画の取得と同じアクセスルールが適用されます。トランスクリプトがまだない録画でも200を返し、"status": "not_started"と空のsegments配列を含みます。
クエリパラメーター
Section titled “クエリパラメーター”| パラメーター | 種類 | 既定値 | 説明 |
|---|---|---|---|
start_chunk | integer | 0 | 返す最初のチャンクのインデックス |
limit | integer | 50 | チャンクの数 (1から100) |
{ "data": { "status": "completed", "language": "en", "speakers": ["Alice", "Bob"], "duration": 1740.5, "segments": [ { "id": 1, "start": 0.5, "end": 3.2, "text": "Good morning everyone.", "speaker": "Alice", "confidence": 0.97 } ], "pagination": { "total_chunks": 4, "has_more": true } }}startとendの単位は秒です。speakerとconfidenceはnullになる場合があります。has_moreがtrueの間は、より大きいstart_chunkで次のページをリクエストしてください。
エラー: ロックされた録画の場合は403 RECORDING_LOCKED、組織またはメンバーで文字起こしが無効な場合は403 TRANSCRIPT_NOT_AVAILABLE、完全なトランスクリプトに有料プランが必要な場合は403 SUBSCRIPTION_REQUIRED、404 RECORDING_NOT_FOUND、402 ORGANIZATION_SUBSCRIPTION_EXPIRED。
PATCH /v1/recordings/:id録画の名前を変更するか、会議メモを置き換えるか、その両方を行います。少なくとも1つのフィールドが必要です。
リクエストボディ
Section titled “リクエストボディ”{ "title": "New title", "notes": "## Notes\nIn Markdown"}| フィールド | 説明 |
|---|---|
title | 1から500文字 |
notes | Markdown形式の会議メモ (最大100,000文字)。既存のメモを置き換えます |
空の本文で204 No Content。
エラー: 400 VALIDATION_ERROR、404 RECORDING_NOT_FOUND。
DELETE /v1/recordings/:id録画とすべてのデータ (トランスクリプト、メモ、共有リンク) を完全に削除します。
空の本文で204 No Content。
エラー: 404 RECORDING_NOT_FOUND。
共有リンクの作成
Section titled “共有リンクの作成”POST /v1/recordings/:id/share-link録画の公開共有リンクを作成するか、既存のリンクを置き換えます。以前のリンクは使用できなくなります。
組織の録画では、録画を表示できるすべてのメンバーがリンクを作成できます。リンクは録画の所有者に代わって作成され、組織のプランを使用します。
リクエストボディ
Section titled “リクエストボディ”{ "permission": "view"}| 値 | 説明 |
|---|---|
view | リンクを持つ人は録画を視聴できます |
download | リンクを持つ人はダウンロードもできます |
{ "data": { "share_url": "https://recordmeeting.com/app/shared/abc123", "share_token": "abc123", "permission": "view" }}エラー: 400 VALIDATION_ERROR、録画をまだ共有できない場合は400 RECORDING_NOT_READY、403 RECORDING_LOCKED、組織またはメンバーで共有が無効な場合は403 SHARING_DISABLED、権限に有料プランが必要な場合は403 SUBSCRIPTION_REQUIRED、404 RECORDING_NOT_FOUND、402 ORGANIZATION_SUBSCRIPTION_EXPIRED。
録画のステータス
Section titled “録画のステータス”| ステータス | 説明 |
|---|---|
STARTING | 録画を設定しています |
CONNECTING | 会議に接続しています |
WAIT_APPROVAL | 録画の承認を待っています |
RECORDING | 録画中です |
STALE | 完了前に録画のデータ送信が停止しました |
UPLOADING | 録画は停止し、アップロード中です |
PROCESSING | 動画を処理中であり、まだ再生できません |
MIGRATING | 長期保存先に移動中も動画を再生できます |
COMPLETED | 録画は完全に処理されました |
ERROR | 録画は失敗しました |