Ir al contenido

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.

GET /v1/recordings

Devuelve una lista paginada de las grabaciones a las que tienes acceso.

ParámetroTipoPredeterminadoDescripción
limitinteger20Número de resultados (1 a 100)
offsetinteger0Desplazamiento de paginación
searchstringningunoFiltrar por texto en el título
statusstringningunoFiltrar por estado (consulta Estados de las grabaciones)
date_fromstringningunoFecha y hora en ISO 8601. Solo las grabaciones creadas en esa fecha o después
date_tostringningunoFecha y hora en ISO 8601. Solo las grabaciones creadas en esa fecha o antes
organization_idstringningunoLista las grabaciones de una organización
folder_idstringningunoLista las grabaciones de una carpeta
user_idstringningunoFiltrar por usuario. Para administradores de organización que quieren las grabaciones de un miembro concreto
{
"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.


GET /v1/recordings/:id

Devuelve 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.

{
"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
}
}
}
CampoDescripción
notesLas notas de la reunión en Markdown. null cuando no hay ninguna o la grabación está bloqueada
download_urlUn enlace de descarga temporal. null a menos que capabilities.canDownload sea true. Caduca en download_url_expires_at
mediaEnlaces temporales de reproducción. Vuelve a solicitar la grabación cuando haya pasado expires_at
media_typevideo o audio
is_lockedtrue cuando la grabación está bloqueada. En ese caso, transcription y notes son null
open_urlLa página de la grabación en la aplicación web
sharing.share_urlEl 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.


GET /v1/recordings/:id/transcript

Devuelve 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ámetroTipoPredeterminadoDescripción
start_chunkinteger0Índice del primer fragmento que se devuelve
limitinteger50Número de fragmentos (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 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.


PATCH /v1/recordings/:id

Cambia el nombre de una grabación, reemplaza sus notas de la reunión o ambas cosas. Se requiere al menos un campo.

{
"title": "New title",
"notes": "## Notes\nIn Markdown"
}
CampoDescripción
titleDe 1 a 500 caracteres
notesNotas de la reunión en Markdown, hasta 100.000 caracteres. Reemplaza las notas existentes

204 No Content con un cuerpo vacío.

Errores: 400 VALIDATION_ERROR, 404 RECORDING_NOT_FOUND.


DELETE /v1/recordings/:id

Elimina de forma permanente una grabación y todos sus datos: la transcripción, las notas y los enlaces para compartir.

204 No Content con un cuerpo vacío.

Errores: 404 RECORDING_NOT_FOUND.


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

Crea 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.

{
"permission": "view"
}
ValorDescripción
viewLas personas con el enlace pueden ver la grabación
downloadLas personas con el enlace también pueden descargarla
{
"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.


EstadoDescripción
STARTINGLa grabación se está preparando
CONNECTINGConectando con la reunión
WAIT_APPROVALEsperando la aprobación para grabar
RECORDINGLa grabación está en curso
STALELa grabación dejó de enviar datos antes de terminar
UPLOADINGLa grabación se ha detenido y aún se está subiendo
PROCESSINGEl video se está procesando y aún no se puede reproducir
MIGRATINGEl video se puede reproducir mientras se traslada al almacenamiento a largo plazo
COMPLETEDLa grabación está totalmente procesada
ERRORLa grabación ha fallado