콘텐츠로 이동

녹화

녹화, 스크립트, 공유 링크를 위한 엔드포인트입니다. 모든 경로는 https://api.recordmeeting.com에 있으며 API 키가 필요합니다. 인증을 참조하세요.

GET /v1/recordings

액세스할 수 있는 녹화의 페이지별 목록을 반환합니다.

매개변수유형기본값설명
limit정수20결과 수(1~100)
offset정수0페이지네이션 오프셋
search문자열없음제목의 텍스트로 필터링
status문자열없음상태로 필터링(녹화 상태 참조)
date_from문자열없음ISO 8601 날짜 및 시간. 해당 시각 이후에 생성된 녹화만
date_to문자열없음ISO 8601 날짜 및 시간. 해당 시각 이전에 생성된 녹화만
organization_id문자열없음조직의 녹화 목록 조회
folder_id문자열없음폴더의 녹화 목록 조회
user_id문자열없음사용자로 필터링. 한 구성원의 녹화를 원하는 조직 관리자용
{
"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를 사용하면 편집자와 뷰어는 볼 수 있는 권한이 있는 녹화만 받습니다. 이때 total은 상한이며, 페이지에는 limit보다 적은 항목이 포함될 수 있습니다.

오류: 400 VALIDATION_ERROR, 해당 조직의 녹화를 나열할 수 없는 경우 403 FORBIDDEN.


GET /v1/recordings/:id

한 녹화의 전체 세부 정보를 반환합니다.

조직 녹화는 해당 녹화를 볼 수 있는 구성원이면 누구에게나 반환됩니다. 소유자와 관리자는 조직의 모든 녹화를 열 수 있습니다. 편집자와 뷰어는 자신의 역할과 폴더가 허용하는 범위의 녹화를 봅니다. 조직 녹화의 경우 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_url웹 앱의 해당 녹화 페이지입니다.
sharing.share_url녹화의 공유 링크이며, 없으면 null입니다.

오류: 404 RECORDING_NOT_FOUND, 조직의 Enterprise 구독이 더 이상 활성 상태가 아닌 경우 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.


GET /v1/recordings/:id/transcript

녹화의 스크립트를 세그먼트로 반환하며, 청크 단위의 페이지로 제공합니다.

조직 녹화는 녹화 상세 조회와 동일한 액세스 규칙을 따릅니다. 아직 스크립트가 없는 녹화도 200을 반환하며, "status": "not_started"와 빈 segments 배열을 포함합니다.

매개변수유형기본값설명
start_chunk정수0반환할 첫 번째 청크의 인덱스
limit정수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

녹화 이름을 바꾸거나 회의 노트를 교체하거나 둘 다 수행합니다. 필드를 하나 이상 제공해야 합니다.

{
"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녹화에 실패했습니다