Ga naar inhoud

Opnamen

Eindpunten voor opnamen, transcripten en deellinks. Alle paden bevinden zich op https://api.recordmeeting.com en vereisen een API-sleutel. Zie Authenticatie.

GET /v1/recordings

Retourneert een gepagineerde lijst met de opnamen waartoe je toegang hebt.

ParameterTypeStandaardBeschrijving
limitinteger20Aantal resultaten (1 tot 100)
offsetinteger0Offset voor paginering
searchstringnoneFilteren op tekst in de titel
statusstringnoneFilteren op status (zie Opnamestatussen)
date_fromstringnoneISO 8601 datum-tijd. Alleen opnamen die op of na dit moment zijn gemaakt
date_tostringnoneISO 8601 datum-tijd. Alleen opnamen die op of voor dit moment zijn gemaakt
organization_idstringnoneDe opnamen van een organisatie weergeven
folder_idstringnoneDe opnamen van een map weergeven
user_idstringnoneFilteren op gebruiker. Voor organisatiebeheerders die de opnamen van één lid willen zien
{
"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.


GET /v1/recordings/:id

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

{
"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
}
}
}
VeldBeschrijving
notesDe vergadernotities in Markdown. null wanneer er geen zijn of de opname is vergrendeld
download_urlEen tijdelijke downloadlink. null tenzij capabilities.canDownload true is. Deze verloopt op download_url_expires_at
mediaTijdelijke afspeellinks. Vraag de opname opnieuw op zodra expires_at is verstreken
media_typevideo of audio
is_lockedtrue wanneer de opname is vergrendeld. transcription en notes zijn dan null
open_urlDe pagina van de opname in de webapp
sharing.share_urlDe 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.


GET /v1/recordings/:id/transcript

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

ParameterTypeStandaardBeschrijving
start_chunkinteger0Index van de eerste chunk die wordt geretourneerd
limitinteger50Aantal chunks (1 tot 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 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.


PATCH /v1/recordings/:id

Wijzigt de naam van een opname, vervangt de vergadernotities, of beide. Ten minste één veld is vereist.

{
"title": "New title",
"notes": "## Notes\nIn Markdown"
}
VeldBeschrijving
title1 tot 500 tekens
notesVergadernotities in Markdown, tot 100.000 tekens. Vervangt de bestaande notities

204 No Content met een lege body.

Fouten: 400 VALIDATION_ERROR, 404 RECORDING_NOT_FOUND.


DELETE /v1/recordings/:id

Verwijdert een opname permanent met alle gegevens: het transcript, de notities en de deellinks.

204 No Content met een lege body.

Fouten: 404 RECORDING_NOT_FOUND.


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

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

{
"permission": "view"
}
WaardeBeschrijving
viewMensen met de link kunnen de opname bekijken
downloadMensen met de link kunnen deze ook downloaden
{
"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.


StatusBeschrijving
STARTINGDe opname wordt ingesteld
CONNECTINGVerbinding maken met de vergadering
WAIT_APPROVALWachten op goedkeuring om op te nemen
RECORDINGOpname is bezig
STALEDe opname is gestopt met het verzenden van gegevens voordat deze was voltooid
UPLOADINGDe opname is gestopt en wordt nog geüpload
PROCESSINGDe video wordt verwerkt en kan nog niet worden afgespeeld
MIGRATINGDe video kan worden afgespeeld terwijl deze naar langetermijnopslag wordt verplaatst
COMPLETEDDe opname is volledig verwerkt
ERRORDe opname is mislukt