コンテンツにスキップ

録画

録画、トランスクリプト、共有リンク用のエンドポイントです。すべてのパスは https://api.recordmeeting.com 上にあり、APIキーが必要です。認証を参照してください。

GET /v1/recordings

アクセスできる録画のページ分けされた一覧を返します。

パラメーター種類既定値説明
limitinteger20結果の件数 (1から100)
offsetinteger0ページネーションのオフセット
searchstringnoneタイトル内のテキストで絞り込みます
statusstringnoneステータスで絞り込みます (録画のステータスを参照してください)
date_fromstringnoneISO 8601形式の日付と時刻。この日時以降に作成された録画のみ
date_tostringnoneISO 8601形式の日付と時刻。この日時以前に作成された録画のみ
organization_idstringnone組織の録画を一覧表示します
folder_idstringnoneフォルダーの録画を一覧表示します
user_idstringnoneユーザーで絞り込みます。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/:id

1件の録画の完全な詳細を返します。

組織の録画は、表示できるすべてのメンバーに返されます。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
}
}
}
フィールド説明
notesMarkdown形式の会議メモ。メモがない場合や録画がロックされている場合はnull
download_url一時的なダウンロードリンク。capabilities.canDownloadがtrueの場合を除きnull。download_url_expires_atに有効期限が切れます
media一時的な再生リンク。expires_atを過ぎたら録画を再度リクエストしてください
media_typevideoまたはaudio
is_locked録画がロックされている場合はtrue。その場合、transcriptionとnotesはnullです
open_urlWebアプリ内の録画ページ
sharing.share_url録画の共有リンク。ない場合はnull

エラー: 404 RECORDING_NOT_FOUND、組織のEnterpriseサブスクリプションが有効でなくなった場合402 ORGANIZATION_SUBSCRIPTION_EXPIRED。


GET /v1/recordings/:id/transcript

録画のトランスクリプトをチャンク単位のページでセグメントとして返します。

組織の録画には録画の取得と同じアクセスルールが適用されます。トランスクリプトがまだない録画でも200を返し、"status": "not_started"と空のsegments配列を含みます。

パラメーター種類既定値説明
start_chunkinteger0返す最初のチャンクのインデックス
limitinteger50チャンクの数 (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つのフィールドが必要です。

{
"title": "New title",
"notes": "## Notes\nIn Markdown"
}
フィールド説明
title1から500文字
notesMarkdown形式の会議メモ (最大100,000文字)。既存のメモを置き換えます

空の本文で204 No Content。

エラー: 400 VALIDATION_ERROR、404 RECORDING_NOT_FOUND。


DELETE /v1/recordings/:id

録画とすべてのデータ (トランスクリプト、メモ、共有リンク) を完全に削除します。

空の本文で204 No Content。

エラー: 404 RECORDING_NOT_FOUND。


POST /v1/recordings/:id/share-link

録画の公開共有リンクを作成するか、既存のリンクを置き換えます。以前のリンクは使用できなくなります。

組織の録画では、録画を表示できるすべてのメンバーがリンクを作成できます。リンクは録画の所有者に代わって作成され、組織のプランを使用します。

{
"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。


ステータス説明
STARTING録画を設定しています
CONNECTING会議に接続しています
WAIT_APPROVAL録画の承認を待っています
RECORDING録画中です
STALE完了前に録画のデータ送信が停止しました
UPLOADING録画は停止し、アップロード中です
PROCESSING動画を処理中であり、まだ再生できません
MIGRATING長期保存先に移動中も動画を再生できます
COMPLETED録画は完全に処理されました
ERROR録画は失敗しました