Grabaciones
Endpoints para grabaciones, transcripciones y enlaces para compartir. Todas las rutas están en https://api.recordmeeting.com y requieren una clave de API. Consulta Autenticación.
Listar grabaciones
Sección titulada «Listar grabaciones»GET /v1/recordingsDevuelve una lista paginada de las grabaciones a las que tienes acceso.
Parámetros de consulta
Sección titulada «Parámetros de consulta»| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
limit | integer | 20 | Número de resultados (1 a 100) |
offset | integer | 0 | Desplazamiento de paginación |
search | string | ninguno | Filtrar por texto en el título |
status | string | ninguno | Filtrar por estado (consulta Estados de las grabaciones) |
date_from | string | ninguno | Fecha y hora en ISO 8601. Solo las grabaciones creadas en esa fecha o después |
date_to | string | ninguno | Fecha y hora en ISO 8601. Solo las grabaciones creadas en esa fecha o antes |
organization_id | string | ninguno | Lista las grabaciones de una organización |
folder_id | string | ninguno | Lista las grabaciones de una carpeta |
user_id | string | ninguno | Filtrar por usuario. Para administradores de organización que quieren las grabaciones de un miembro concreto |
Respuesta
Sección titulada «Respuesta»{ "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 y processing_progress pueden ser null. En una grabación bloqueada, transcription_status y notes_status son null.
Con organization_id, los Editores y los Lectores solo obtienen las grabaciones que tienen permitido ver. En ese caso, total es un límite superior y una página puede contener menos de limit elementos.
Errores: 400 VALIDATION_ERROR, 403 FORBIDDEN cuando no puedes listar las grabaciones de esa organización.
Obtener una grabación
Sección titulada «Obtener una grabación»GET /v1/recordings/:idDevuelve todos los detalles de una grabación.
Una grabación de organización se devuelve a cualquier miembro que pueda verla. Los Propietarios y Administradores pueden abrir todas las grabaciones de su organización. Los Editores y Lectores ven lo que permiten su rol y sus carpetas. En una grabación de organización, is_locked, download_url y capabilities dependen del plan de la organización y del acceso a funciones del miembro, no de tu plan personal.
Respuesta
Sección titulada «Respuesta»{ "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 que debes conocer
Sección titulada «Campos que debes conocer»| Campo | Descripción |
|---|---|
notes | Las notas de la reunión en Markdown. null cuando no hay ninguna o la grabación está bloqueada |
download_url | Un enlace de descarga temporal. null a menos que capabilities.canDownload sea true. Caduca en download_url_expires_at |
media | Enlaces temporales de reproducción. Vuelve a solicitar la grabación cuando haya pasado expires_at |
media_type | video o audio |
is_locked | true cuando la grabación está bloqueada. En ese caso, transcription y notes son null |
open_url | La página de la grabación en la aplicación web |
sharing.share_url | El enlace para compartir de la grabación, o null cuando no tiene ninguno |
Errores: 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED cuando la suscripción Enterprise de la organización ya no está activa.
Obtener la transcripción
Sección titulada «Obtener la transcripción»GET /v1/recordings/:id/transcriptDevuelve la transcripción de una grabación como segmentos, en páginas de fragmentos.
Las grabaciones de organización siguen las mismas reglas de acceso que Obtener una grabación. Una grabación que aún no tiene transcripción sigue devolviendo 200, con "status": "not_started" y un array segments vacío.
Parámetros de consulta
Sección titulada «Parámetros de consulta»| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
start_chunk | integer | 0 | Índice del primer fragmento que se devuelve |
limit | integer | 50 | Número de fragmentos (1 a 100) |
Respuesta
Sección titulada «Respuesta»{ "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 y end están en segundos. speaker y confidence pueden ser null. Mientras has_more sea true, solicita la página siguiente con un start_chunk mayor.
Errores: 403 RECORDING_LOCKED para una grabación bloqueada, 403 TRANSCRIPT_NOT_AVAILABLE cuando la transcripción está desactivada para la organización o el miembro, 403 SUBSCRIPTION_REQUIRED cuando la transcripción completa necesita un plan de pago, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.
Actualizar una grabación
Sección titulada «Actualizar una grabación»PATCH /v1/recordings/:idCambia el nombre de una grabación, reemplaza sus notas de la reunión o ambas cosas. Se requiere al menos un campo.
Cuerpo de la solicitud
Sección titulada «Cuerpo de la solicitud»{ "title": "New title", "notes": "## Notes\nIn Markdown"}| Campo | Descripción |
|---|---|
title | De 1 a 500 caracteres |
notes | Notas de la reunión en Markdown, hasta 100.000 caracteres. Reemplaza las notas existentes |
Respuesta
Sección titulada «Respuesta»204 No Content con un cuerpo vacío.
Errores: 400 VALIDATION_ERROR, 404 RECORDING_NOT_FOUND.
Eliminar una grabación
Sección titulada «Eliminar una grabación»DELETE /v1/recordings/:idElimina de forma permanente una grabación y todos sus datos: la transcripción, las notas y los enlaces para compartir.
Respuesta
Sección titulada «Respuesta»204 No Content con un cuerpo vacío.
Errores: 404 RECORDING_NOT_FOUND.
Crear un enlace para compartir
Sección titulada «Crear un enlace para compartir»POST /v1/recordings/:id/share-linkCrea el enlace público para compartir de una grabación o reemplaza el que ya tiene. El enlace anterior deja de funcionar.
En una grabación de organización, cualquier miembro que pueda ver la grabación puede crear el enlace. Se crea en nombre del propietario de la grabación y usa el plan de la organización.
Cuerpo de la solicitud
Sección titulada «Cuerpo de la solicitud»{ "permission": "view"}| Valor | Descripción |
|---|---|
view | Las personas con el enlace pueden ver la grabación |
download | Las personas con el enlace también pueden descargarla |
Respuesta
Sección titulada «Respuesta»{ "data": { "share_url": "https://recordmeeting.com/app/shared/abc123", "share_token": "abc123", "permission": "view" }}Errores: 400 VALIDATION_ERROR, 400 RECORDING_NOT_READY cuando la grabación aún no se puede compartir, 403 RECORDING_LOCKED, 403 SHARING_DISABLED cuando el uso compartido está desactivado para la organización o el miembro, 403 SUBSCRIPTION_REQUIRED cuando el permiso necesita un plan de pago, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.
Estados de las grabaciones
Sección titulada «Estados de las grabaciones»| Estado | Descripción |
|---|---|
STARTING | La grabación se está preparando |
CONNECTING | Conectando con la reunión |
WAIT_APPROVAL | Esperando la aprobación para grabar |
RECORDING | La grabación está en curso |
STALE | La grabación dejó de enviar datos antes de terminar |
UPLOADING | La grabación se ha detenido y aún se está subiendo |
PROCESSING | El video se está procesando y aún no se puede reproducir |
MIGRATING | El video se puede reproducir mientras se traslada al almacenamiento a largo plazo |
COMPLETED | La grabación está totalmente procesada |
ERROR | La grabación ha fallado |