Opnamen
Eindpunten voor opnamen, transcripten en deellinks. Alle paden bevinden zich op https://api.recordmeeting.com en vereisen een API-sleutel. Zie Authenticatie.
Opnamen weergeven
Section titled “Opnamen weergeven”GET /v1/recordingsRetourneert een gepagineerde lijst met de opnamen waartoe je toegang hebt.
Queryparameters
Section titled “Queryparameters”| Parameter | Type | Standaard | Beschrijving |
|---|---|---|---|
limit | integer | 20 | Aantal resultaten (1 tot 100) |
offset | integer | 0 | Offset voor paginering |
search | string | none | Filteren op tekst in de titel |
status | string | none | Filteren op status (zie Opnamestatussen) |
date_from | string | none | ISO 8601 datum-tijd. Alleen opnamen die op of na dit moment zijn gemaakt |
date_to | string | none | ISO 8601 datum-tijd. Alleen opnamen die op of voor dit moment zijn gemaakt |
organization_id | string | none | De opnamen van een organisatie weergeven |
folder_id | string | none | De opnamen van een map weergeven |
user_id | string | none | Filteren op gebruiker. Voor organisatiebeheerders die de opnamen van één lid willen zien |
Respons
Section titled “Respons”{ "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 en processing_progress kunnen null zijn. Voor een vergrendelde opname zijn transcription_status en notes_status null.
Met organization_id krijgen Editors en Viewers alleen de opnamen te zien die ze mogen bekijken. total is dan een bovengrens en een pagina kan minder dan limit items bevatten.
Fouten: 400 VALIDATION_ERROR, 403 FORBIDDEN wanneer je de opnamen van die organisatie niet mag weergeven.
Opname ophalen
Section titled “Opname ophalen”GET /v1/recordings/:idRetourneert alle details voor één opname.
Een organisatieopname wordt geretourneerd aan elk lid dat deze mag bekijken. Eigenaren en beheerders kunnen elke opname in hun organisatie openen. Editors en Viewers zien wat hun rol en mappen toestaan. Voor een organisatieopname volgen is_locked, download_url en capabilities het abonnement van de organisatie en de functietoegang van het lid, niet je persoonlijke abonnement.
Respons
Section titled “Respons”{ "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 } }}Belangrijke velden
Section titled “Belangrijke velden”| Veld | Beschrijving |
|---|---|
notes | De vergadernotities in Markdown. null wanneer er geen zijn of de opname is vergrendeld |
download_url | Een tijdelijke downloadlink. null tenzij capabilities.canDownload true is. Deze verloopt op download_url_expires_at |
media | Tijdelijke afspeellinks. Vraag de opname opnieuw op zodra expires_at is verstreken |
media_type | video of audio |
is_locked | true wanneer de opname is vergrendeld. transcription en notes zijn dan null |
open_url | De pagina van de opname in de webapp |
sharing.share_url | De deellink van de opname, of null wanneer deze er geen heeft |
Fouten: 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED wanneer het Enterprise-abonnement van de organisatie niet meer actief is.
Transcript ophalen
Section titled “Transcript ophalen”GET /v1/recordings/:id/transcriptRetourneert het transcript van een opname als segmenten, in pagina’s met chunks.
Organisatieopnamen volgen dezelfde toegangsregels als Opname ophalen. Een opname die nog geen transcript heeft, retourneert toch 200, met "status": "not_started" en een lege segments-array.
Queryparameters
Section titled “Queryparameters”| Parameter | Type | Standaard | Beschrijving |
|---|---|---|---|
start_chunk | integer | 0 | Index van de eerste chunk die wordt geretourneerd |
limit | integer | 50 | Aantal chunks (1 tot 100) |
Respons
Section titled “Respons”{ "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 en end zijn in seconden. speaker en confidence kunnen null zijn. Zolang has_more true is, vraag je de volgende pagina op met een hogere start_chunk.
Fouten: 403 RECORDING_LOCKED voor een vergrendelde opname, 403 TRANSCRIPT_NOT_AVAILABLE wanneer transcriptie is uitgeschakeld voor de organisatie of het lid, 403 SUBSCRIPTION_REQUIRED wanneer het volledige transcript een betaald abonnement vereist, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.
Opname bijwerken
Section titled “Opname bijwerken”PATCH /v1/recordings/:idWijzigt de naam van een opname, vervangt de vergadernotities, of beide. Ten minste één veld is vereist.
Aanvraagbody
Section titled “Aanvraagbody”{ "title": "New title", "notes": "## Notes\nIn Markdown"}| Veld | Beschrijving |
|---|---|
title | 1 tot 500 tekens |
notes | Vergadernotities in Markdown, tot 100.000 tekens. Vervangt de bestaande notities |
Respons
Section titled “Respons”204 No Content met een lege body.
Fouten: 400 VALIDATION_ERROR, 404 RECORDING_NOT_FOUND.
Opname verwijderen
Section titled “Opname verwijderen”DELETE /v1/recordings/:idVerwijdert een opname permanent met alle gegevens: het transcript, de notities en de deellinks.
Respons
Section titled “Respons”204 No Content met een lege body.
Fouten: 404 RECORDING_NOT_FOUND.
Deellink maken
Section titled “Deellink maken”POST /v1/recordings/:id/share-linkMaakt de openbare deellink van een opname, of vervangt de bestaande link. De vorige link werkt niet meer.
Voor een organisatieopname mag elk lid dat de opname mag bekijken de link maken. Deze wordt gemaakt namens de eigenaar van de opname en gebruikt het abonnement van de organisatie.
Aanvraagbody
Section titled “Aanvraagbody”{ "permission": "view"}| Waarde | Beschrijving |
|---|---|
view | Mensen met de link kunnen de opname bekijken |
download | Mensen met de link kunnen deze ook downloaden |
Respons
Section titled “Respons”{ "data": { "share_url": "https://recordmeeting.com/app/shared/abc123", "share_token": "abc123", "permission": "view" }}Fouten: 400 VALIDATION_ERROR, 400 RECORDING_NOT_READY wanneer de opname nog niet kan worden gedeeld, 403 RECORDING_LOCKED, 403 SHARING_DISABLED wanneer delen is uitgeschakeld voor de organisatie of het lid, 403 SUBSCRIPTION_REQUIRED wanneer de toestemming een betaald abonnement vereist, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.
Opnamestatussen
Section titled “Opnamestatussen”| Status | Beschrijving |
|---|---|
STARTING | De opname wordt ingesteld |
CONNECTING | Verbinding maken met de vergadering |
WAIT_APPROVAL | Wachten op goedkeuring om op te nemen |
RECORDING | Opname is bezig |
STALE | De opname is gestopt met het verzenden van gegevens voordat deze was voltooid |
UPLOADING | De opname is gestopt en wordt nog geüpload |
PROCESSING | De video wordt verwerkt en kan nog niet worden afgespeeld |
MIGRATING | De video kan worden afgespeeld terwijl deze naar langetermijnopslag wordt verplaatst |
COMPLETED | De opname is volledig verwerkt |
ERROR | De opname is mislukt |