Zum Inhalt springen

Aufnahmen

Endpunkte für Aufnahmen, Transkripte und Freigabelinks. Alle Pfade liegen auf https://api.recordmeeting.com und erfordern einen API-Schlüssel. Siehe Authentifizierung.

GET /v1/recordings

Gibt eine seitenweise Liste der Aufnahmen zurück, auf die Sie zugreifen können.

ParameterTypStandardBeschreibung
limitinteger20Anzahl der Ergebnisse (1 bis 100)
offsetinteger0Offset für die Seitennummerierung
searchstringkeinerNach Text im Titel filtern
statusstringkeinerNach Status filtern (siehe Status von Aufnahmen)
date_fromstringkeinerISO 8601 Datum und Uhrzeit. Nur Aufnahmen, die zu diesem Zeitpunkt oder danach erstellt wurden
date_tostringkeinerISO 8601 Datum und Uhrzeit. Nur Aufnahmen, die zu diesem Zeitpunkt oder davor erstellt wurden
organization_idstringkeinerDie Aufnahmen einer Organisation auflisten
folder_idstringkeinerDie Aufnahmen eines Ordners auflisten
user_idstringkeinerNach Benutzer filtern. Für Organisations-Admins, die die Aufnahmen eines bestimmten Mitglieds sehen möchten
{
"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 und processing_progress können null sein. Bei einer gesperrten Aufnahme sind transcription_status und notes_status null.

Mit organization_id erhalten Editors und Viewers nur die Aufnahmen, die sie sehen dürfen. total ist dann eine Obergrenze, und eine Seite kann weniger als limit Einträge enthalten.

Fehler: 400 VALIDATION_ERROR, 403 FORBIDDEN, wenn Sie die Aufnahmen dieser Organisation nicht auflisten dürfen.


GET /v1/recordings/:id

Gibt alle Details zu einer Aufnahme zurück.

Eine Organisationsaufnahme wird jedem Mitglied zurückgegeben, das sie ansehen darf. Owners und Admins können jede Aufnahme ihrer Organisation öffnen. Editors und Viewers sehen nur, was ihre Rolle und ihre Ordner zulassen. Bei einer Organisationsaufnahme richten sich is_locked, download_url und capabilities nach dem Tarif der Organisation und dem Funktionszugriff des Mitglieds, nicht nach Ihrem persönlichen Tarif.

{
"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
}
}
}
FeldBeschreibung
notesDie Meeting-Notizen in Markdown. null, wenn keine vorhanden sind oder die Aufnahme gesperrt ist
download_urlEin temporärer Download-Link. null, sofern capabilities.canDownload nicht true ist. Er läuft um download_url_expires_at ab
mediaTemporäre Wiedergabelinks. Rufen Sie die Aufnahme erneut ab, sobald expires_at abgelaufen ist
media_typevideo oder audio
is_lockedtrue, wenn die Aufnahme gesperrt ist. transcription und notes sind dann null
open_urlDie Seite der Aufnahme in der Web-App
sharing.share_urlDer Freigabelink der Aufnahme oder null, wenn keiner vorhanden ist

Fehler: 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED, wenn das Enterprise-Abonnement der Organisation nicht mehr aktiv ist.


GET /v1/recordings/:id/transcript

Gibt das Transkript einer Aufnahme als Segmente zurück, seitenweise in Chunks aufgeteilt.

Für Organisationsaufnahmen gelten dieselben Zugriffsregeln wie unter Aufnahme abrufen. Eine Aufnahme ohne Transkript liefert trotzdem 200, mit "status": "not_started" und einem leeren segments-Array.

ParameterTypStandardBeschreibung
start_chunkinteger0Index des ersten Chunks, der zurückgegeben wird
limitinteger50Anzahl der Chunks (1 bis 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 und end sind in Sekunden angegeben. speaker und confidence können null sein. Solange has_more true ist, fordern Sie die nächste Seite mit einem höheren start_chunk an.

Fehler: 403 RECORDING_LOCKED bei einer gesperrten Aufnahme, 403 TRANSCRIPT_NOT_AVAILABLE, wenn die Transkription für die Organisation oder das Mitglied deaktiviert ist, 403 SUBSCRIPTION_REQUIRED, wenn das vollständige Transkript einen kostenpflichtigen Tarif erfordert, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.


PATCH /v1/recordings/:id

Benennt eine Aufnahme um, ersetzt ihre Meeting-Notizen oder beides. Mindestens ein Feld ist erforderlich.

{
"title": "New title",
"notes": "## Notes\nIn Markdown"
}
FeldBeschreibung
title1 bis 500 Zeichen
notesMeeting-Notizen in Markdown, bis zu 100.000 Zeichen. Ersetzt die vorhandenen Notizen

204 No Content mit leerem Body.

Fehler: 400 VALIDATION_ERROR, 404 RECORDING_NOT_FOUND.


DELETE /v1/recordings/:id

Löscht eine Aufnahme und alle ihre Daten dauerhaft: das Transkript, die Notizen und die Freigabelinks.

204 No Content mit leerem Body.

Fehler: 404 RECORDING_NOT_FOUND.


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

Erstellt den öffentlichen Freigabelink einer Aufnahme oder ersetzt den vorhandenen. Der bisherige Link funktioniert danach nicht mehr.

Bei einer Organisationsaufnahme kann jedes Mitglied, das die Aufnahme ansehen darf, den Link erstellen. Er wird im Namen des Eigentümers der Aufnahme erstellt und nutzt den Tarif der Organisation.

{
"permission": "view"
}
WertBeschreibung
viewPersonen mit dem Link können die Aufnahme ansehen
downloadPersonen mit dem Link können sie auch herunterladen
{
"data": {
"share_url": "https://recordmeeting.com/app/shared/abc123",
"share_token": "abc123",
"permission": "view"
}
}

Fehler: 400 VALIDATION_ERROR, 400 RECORDING_NOT_READY, wenn die Aufnahme noch nicht freigegeben werden kann, 403 RECORDING_LOCKED, 403 SHARING_DISABLED, wenn die Freigabe für die Organisation oder das Mitglied deaktiviert ist, 403 SUBSCRIPTION_REQUIRED, wenn die Berechtigung einen kostenpflichtigen Tarif erfordert, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.


StatusBeschreibung
STARTINGDie Aufnahme wird vorbereitet
CONNECTINGVerbindung zum Meeting wird hergestellt
WAIT_APPROVALWarten auf die Freigabe zur Aufnahme
RECORDINGDie Aufnahme läuft
STALEDie Aufnahme hat keine Daten mehr gesendet, bevor sie abgeschlossen war
UPLOADINGDie Aufnahme wurde beendet und wird noch hochgeladen
PROCESSINGDas Video wird verarbeitet und kann noch nicht abgespielt werden
MIGRATINGDas Video kann abgespielt werden, während es in den Langzeitspeicher verschoben wird
COMPLETEDDie Aufnahme ist vollständig verarbeitet
ERRORDie Aufnahme ist fehlgeschlagen