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.
Listar gravações
Seção intitulada “Listar gravações”GET /v1/recordingsRetorna uma lista paginada das gravações às quais você tem acesso.
Parâmetros de consulta
Seção intitulada “Parâmetros de consulta”| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
limit | integer | 20 | Número de resultados (1 a 100) |
offset | integer | 0 | Deslocamento da paginação |
search | string | none | Filtra pelo texto no título |
status | string | none | Filtra por status (veja Status de gravação) |
date_from | string | none | Data e hora ISO 8601. Apenas gravações criadas a partir dela |
date_to | string | none | Data e hora ISO 8601. Apenas gravações criadas até ela |
organization_id | string | none | Lista as gravações de uma organização |
folder_id | string | none | Lista as gravações de uma pasta |
user_id | string | none | Filtra por usuário. Para administradores da organização que querem as gravações de um membro específico |
Resposta
Seção intitulada “Resposta”{ "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.
Obter gravação
Seção intitulada “Obter gravação”GET /v1/recordings/:idRetorna 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.
Resposta
Seção intitulada “Resposta”{ "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 } }}Campos importantes
Seção intitulada “Campos importantes”| Campo | Descrição |
|---|---|
notes | As notas da reunião em Markdown. null quando não há notas ou quando a gravação está bloqueada |
download_url | Um link temporário de download. null a menos que capabilities.canDownload seja true. Expira em download_url_expires_at |
media | Links temporários de reprodução. Solicite a gravação novamente depois que expires_at passar |
media_type | video ou audio |
is_locked | true quando a gravação está bloqueada. Nesse caso, transcription e notes são null |
open_url | A página da gravação no aplicativo web |
sharing.share_url | O 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.
Obter transcrição
Seção intitulada “Obter transcrição”GET /v1/recordings/:id/transcriptRetorna 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âmetros de consulta
Seção intitulada “Parâmetros de consulta”| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
start_chunk | integer | 0 | Índice do primeiro bloco a retornar |
limit | integer | 50 | Número de blocos (1 a 100) |
Resposta
Seção intitulada “Resposta”{ "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.
Atualizar gravação
Seção intitulada “Atualizar gravação”PATCH /v1/recordings/:idRenomeia uma gravação, substitui as notas da reunião, ou ambos. Pelo menos um campo é obrigatório.
Corpo da requisição
Seção intitulada “Corpo da requisição”{ "title": "New title", "notes": "## Notes\nIn Markdown"}| Campo | Descrição |
|---|---|
title | De 1 a 500 caracteres |
notes | Notas da reunião em Markdown, até 100.000 caracteres. Substitui as notas existentes |
Resposta
Seção intitulada “Resposta”204 No Content com corpo vazio.
Erros: 400 VALIDATION_ERROR, 404 RECORDING_NOT_FOUND.
Excluir gravação
Seção intitulada “Excluir gravação”DELETE /v1/recordings/:idExclui permanentemente uma gravação e todos os seus dados: a transcrição, as notas e os links de compartilhamento.
Resposta
Seção intitulada “Resposta”204 No Content com corpo vazio.
Erros: 404 RECORDING_NOT_FOUND.
Criar link de compartilhamento
Seção intitulada “Criar link de compartilhamento”POST /v1/recordings/:id/share-linkCria 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.
Corpo da requisição
Seção intitulada “Corpo da requisição”{ "permission": "view"}| Valor | Descrição |
|---|---|
view | Pessoas com o link podem assistir à gravação |
download | Pessoas com o link também podem baixá-la |
Resposta
Seção intitulada “Resposta”{ "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.
Status de gravação
Seção intitulada “Status de gravação”| Status | Descrição |
|---|---|
STARTING | A gravação está sendo preparada |
CONNECTING | Conectando à reunião |
WAIT_APPROVAL | Aguardando aprovação para gravar |
RECORDING | A gravação está em andamento |
STALE | A gravação parou de enviar dados antes de ser concluída |
UPLOADING | A gravação parou e ainda está sendo enviada |
PROCESSING | O vídeo está sendo processado e ainda não pode ser reproduzido |
MIGRATING | O vídeo pode ser reproduzido enquanto é movido para o armazenamento de longo prazo |
COMPLETED | A gravação foi totalmente processada |
ERROR | A gravação falhou |