Aller au contenu

Enregistrements

Points de terminaison pour les enregistrements, les transcriptions et les liens de partage. Tous les chemins se trouvent sur https://api.recordmeeting.com et nécessitent une clé d’API. Voir Authentification.

GET /v1/recordings

Renvoie une liste paginée des enregistrements auxquels vous avez accès.

ParamètreTypeValeur par défautDescription
limitinteger20Nombre de résultats (1 à 100)
offsetinteger0Décalage de pagination
searchstringnoneFiltrer par texte dans le titre
statusstringnoneFiltrer par statut (voir Statuts d’enregistrement)
date_fromstringnoneDate et heure ISO 8601. Uniquement les enregistrements créés à cette date ou après
date_tostringnoneDate et heure ISO 8601. Uniquement les enregistrements créés à cette date ou avant
organization_idstringnoneLister les enregistrements d’une organisation
folder_idstringnoneLister les enregistrements d’un dossier
user_idstringnoneFiltrer par utilisateur. Pour les administrateurs d’organisation qui veulent les enregistrements d’un membre
{
"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
}
}

Les champs title, duration_seconds, thumbnail_url, folder_id, organization_id, transcription_status, notes_status et processing_progress peuvent être null. Pour un enregistrement verrouillé, transcription_status et notes_status valent null.

Avec organization_id, les Éditeurs et les Lecteurs ne reçoivent que les enregistrements qu’ils sont autorisés à voir. total est alors une borne supérieure, et une page peut contenir moins d’éléments que limit.

Erreurs : 400 VALIDATION_ERROR, 403 FORBIDDEN lorsque vous n’êtes pas autorisé à lister les enregistrements de cette organisation.


GET /v1/recordings/:id

Renvoie les détails complets d’un enregistrement.

Un enregistrement d’organisation est renvoyé à tout membre autorisé à le consulter. Les Propriétaires et les Administrateurs peuvent ouvrir tous les enregistrements de leur organisation. Les Éditeurs et les Lecteurs voient ce que leur rôle et leurs dossiers autorisent. Pour un enregistrement d’organisation, is_locked, download_url et capabilities suivent le forfait de l’organisation et l’accès du membre aux fonctionnalités, et non votre forfait personnel.

{
"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
}
}
}
ChampDescription
notesLes notes de réunion en Markdown. null lorsqu’il n’y en a pas ou que l’enregistrement est verrouillé
download_urlUn lien de téléchargement temporaire. null sauf si capabilities.canDownload vaut true. Il expire à download_url_expires_at
mediaLiens de lecture temporaires. Redemandez l’enregistrement une fois expires_at dépassé
media_typevideo ou audio
is_lockedtrue lorsque l’enregistrement est verrouillé. transcription et notes valent alors null
open_urlLa page de l’enregistrement dans l’application web
sharing.share_urlLe lien de partage de l’enregistrement, ou null s’il n’en a pas

Erreurs : 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED lorsque l’abonnement Enterprise de l’organisation n’est plus actif.


GET /v1/recordings/:id/transcript

Renvoie la transcription d’un enregistrement sous forme de segments, par pages de blocs.

Les enregistrements d’organisation suivent les mêmes règles d’accès que Obtenir un enregistrement. Un enregistrement qui n’a pas encore de transcription renvoie quand même 200, avec "status": "not_started" et un tableau segments vide.

ParamètreTypeValeur par défautDescription
start_chunkinteger0Index du premier bloc à renvoyer
limitinteger50Nombre de blocs (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 et end sont en secondes. speaker et confidence peuvent être null. Tant que has_more vaut true, demandez la page suivante avec un start_chunk plus élevé.

Erreurs : 403 RECORDING_LOCKED pour un enregistrement verrouillé, 403 TRANSCRIPT_NOT_AVAILABLE lorsque la transcription est désactivée pour l’organisation ou le membre, 403 SUBSCRIPTION_REQUIRED lorsque la transcription complète nécessite un forfait payant, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.


PATCH /v1/recordings/:id

Renomme un enregistrement, remplace ses notes de réunion, ou les deux. Au moins un champ est requis.

{
"title": "New title",
"notes": "## Notes\nIn Markdown"
}
ChampDescription
title1 à 500 caractères
notesNotes de réunion en Markdown, jusqu’à 100 000 caractères. Remplace les notes existantes

204 No Content avec un corps vide.

Erreurs : 400 VALIDATION_ERROR, 404 RECORDING_NOT_FOUND.


DELETE /v1/recordings/:id

Supprime définitivement un enregistrement et toutes ses données : la transcription, les notes et les liens de partage.

204 No Content avec un corps vide.

Erreurs : 404 RECORDING_NOT_FOUND.


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

Crée le lien de partage public d’un enregistrement, ou remplace celui qu’il possède. Le lien précédent cesse de fonctionner.

Pour un enregistrement d’organisation, tout membre qui peut consulter l’enregistrement peut créer le lien. Il est créé au nom du propriétaire de l’enregistrement et utilise le forfait de l’organisation.

{
"permission": "view"
}
ValeurDescription
viewLes personnes disposant du lien peuvent regarder l’enregistrement
downloadLes personnes disposant du lien peuvent aussi le télécharger
{
"data": {
"share_url": "https://recordmeeting.com/app/shared/abc123",
"share_token": "abc123",
"permission": "view"
}
}

Erreurs : 400 VALIDATION_ERROR, 400 RECORDING_NOT_READY lorsque l’enregistrement ne peut pas encore être partagé, 403 RECORDING_LOCKED, 403 SHARING_DISABLED lorsque le partage est désactivé pour l’organisation ou le membre, 403 SUBSCRIPTION_REQUIRED lorsque l’autorisation nécessite un forfait payant, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.


StatutDescription
STARTINGL’enregistrement est en cours de préparation
CONNECTINGConnexion à la réunion
WAIT_APPROVALEn attente de l’autorisation d’enregistrer
RECORDINGL’enregistrement est en cours
STALEL’enregistrement a cessé d’envoyer des données avant d’être terminé
UPLOADINGL’enregistrement est terminé et son envoi est toujours en cours
PROCESSINGLa vidéo est en cours de traitement et ne peut pas encore être lue
MIGRATINGLa vidéo peut être lue pendant son déplacement vers le stockage à long terme
COMPLETEDL’enregistrement est entièrement traité
ERRORL’enregistrement a échoué