Pular para o conteúdo

Gravações

Endpoints para gravações, transcrições e links de compartilhamento. Todos os caminhos ficam em https://api.recordmeeting.com e exigem uma chave de API. Veja Autenticação.

GET /v1/recordings

Retorna uma lista paginada das gravações às quais você tem acesso.

ParâmetroTipoPadrãoDescrição
limitinteger20Número de resultados (1 a 100)
offsetinteger0Deslocamento da paginação
searchstringnoneFiltra pelo texto no título
statusstringnoneFiltra por status (veja Status de gravação)
date_fromstringnoneData e hora ISO 8601. Apenas gravações criadas a partir dela
date_tostringnoneData e hora ISO 8601. Apenas gravações criadas até ela
organization_idstringnoneLista as gravações de uma organização
folder_idstringnoneLista as gravações de uma pasta
user_idstringnoneFiltra por usuário. Para administradores da organização que querem as gravações de um membro específico
{
"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 e processing_progress podem ser null. Em uma gravação bloqueada, transcription_status e notes_status são null.

Com organization_id, Editores e Visualizadores recebem apenas as gravações que têm permissão para ver. Nesse caso, total é um limite superior, e uma página pode conter menos itens que o limit.

Erros: 400 VALIDATION_ERROR, 403 FORBIDDEN quando você não pode listar as gravações dessa organização.


GET /v1/recordings/:id

Retorna os detalhes completos de uma gravação.

Uma gravação da organização é retornada para qualquer membro que tenha permissão para vê-la. Proprietários e Administradores podem abrir todas as gravações da organização. Editores e Visualizadores veem o que o papel e as pastas permitem. Em uma gravação da organização, is_locked, download_url e capabilities seguem o plano da organização e o acesso do membro aos recursos, não o seu plano pessoal.

{
"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
}
}
}
CampoDescrição
notesAs notas da reunião em Markdown. null quando não há notas ou quando a gravação está bloqueada
download_urlUm link temporário de download. null a menos que capabilities.canDownload seja true. Expira em download_url_expires_at
mediaLinks temporários de reprodução. Solicite a gravação novamente depois que expires_at passar
media_typevideo ou audio
is_lockedtrue quando a gravação está bloqueada. Nesse caso, transcription e notes são null
open_urlA página da gravação no aplicativo web
sharing.share_urlO link de compartilhamento da gravação, ou null quando ela não tem nenhum

Erros: 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED quando a assinatura Enterprise da organização não está mais ativa.


GET /v1/recordings/:id/transcript

Retorna a transcrição de uma gravação como segmentos, em páginas de blocos.

Gravações da organização seguem as mesmas regras de acesso de Obter gravação. Uma gravação que ainda não tem transcrição também retorna 200, com "status": "not_started" e um array segments vazio.

ParâmetroTipoPadrãoDescrição
start_chunkinteger0Índice do primeiro bloco a retornar
limitinteger50Número de blocos (1 a 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 e end estão em segundos. speaker e confidence podem ser null. Enquanto has_more for true, solicite a próxima página com um start_chunk maior.

Erros: 403 RECORDING_LOCKED para uma gravação bloqueada, 403 TRANSCRIPT_NOT_AVAILABLE quando a transcrição está desativada para a organização ou para o membro, 403 SUBSCRIPTION_REQUIRED quando a transcrição completa exige um plano pago, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.


PATCH /v1/recordings/:id

Renomeia uma gravação, substitui as notas da reunião, ou ambos. Pelo menos um campo é obrigatório.

{
"title": "New title",
"notes": "## Notes\nIn Markdown"
}
CampoDescrição
titleDe 1 a 500 caracteres
notesNotas da reunião em Markdown, até 100.000 caracteres. Substitui as notas existentes

204 No Content com corpo vazio.

Erros: 400 VALIDATION_ERROR, 404 RECORDING_NOT_FOUND.


DELETE /v1/recordings/:id

Exclui permanentemente uma gravação e todos os seus dados: a transcrição, as notas e os links de compartilhamento.

204 No Content com corpo vazio.

Erros: 404 RECORDING_NOT_FOUND.


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

Cria o link de compartilhamento público de uma gravação, ou substitui o que ela já tem. O link anterior deixa de funcionar.

Em uma gravação da organização, qualquer membro que possa ver a gravação pode criar o link. Ele é criado em nome do proprietário da gravação e usa o plano da organização.

{
"permission": "view"
}
ValorDescrição
viewPessoas com o link podem assistir à gravação
downloadPessoas com o link também podem baixá-la
{
"data": {
"share_url": "https://recordmeeting.com/app/shared/abc123",
"share_token": "abc123",
"permission": "view"
}
}

Erros: 400 VALIDATION_ERROR, 400 RECORDING_NOT_READY quando a gravação ainda não pode ser compartilhada, 403 RECORDING_LOCKED, 403 SHARING_DISABLED quando o compartilhamento está desativado para a organização ou para o membro, 403 SUBSCRIPTION_REQUIRED quando a permissão exige um plano pago, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.


StatusDescrição
STARTINGA gravação está sendo preparada
CONNECTINGConectando à reunião
WAIT_APPROVALAguardando aprovação para gravar
RECORDINGA gravação está em andamento
STALEA gravação parou de enviar dados antes de ser concluída
UPLOADINGA gravação parou e ainda está sendo enviada
PROCESSINGO vídeo está sendo processado e ainda não pode ser reproduzido
MIGRATINGO vídeo pode ser reproduzido enquanto é movido para o armazenamento de longo prazo
COMPLETEDA gravação foi totalmente processada
ERRORA gravação falhou