Aufnahmen
Endpunkte für Aufnahmen, Transkripte und Freigabelinks. Alle Pfade liegen auf https://api.recordmeeting.com und erfordern einen API-Schlüssel. Siehe Authentifizierung.
Aufnahmen auflisten
Abschnitt betitelt „Aufnahmen auflisten“GET /v1/recordingsGibt eine seitenweise Liste der Aufnahmen zurück, auf die Sie zugreifen können.
Query-Parameter
Abschnitt betitelt „Query-Parameter“| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
limit | integer | 20 | Anzahl der Ergebnisse (1 bis 100) |
offset | integer | 0 | Offset für die Seitennummerierung |
search | string | keiner | Nach Text im Titel filtern |
status | string | keiner | Nach Status filtern (siehe Status von Aufnahmen) |
date_from | string | keiner | ISO 8601 Datum und Uhrzeit. Nur Aufnahmen, die zu diesem Zeitpunkt oder danach erstellt wurden |
date_to | string | keiner | ISO 8601 Datum und Uhrzeit. Nur Aufnahmen, die zu diesem Zeitpunkt oder davor erstellt wurden |
organization_id | string | keiner | Die Aufnahmen einer Organisation auflisten |
folder_id | string | keiner | Die Aufnahmen eines Ordners auflisten |
user_id | string | keiner | Nach Benutzer filtern. Für Organisations-Admins, die die Aufnahmen eines bestimmten Mitglieds sehen möchten |
Antwort
Abschnitt betitelt „Antwort“{ "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.
Aufnahme abrufen
Abschnitt betitelt „Aufnahme abrufen“GET /v1/recordings/:idGibt 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.
Antwort
Abschnitt betitelt „Antwort“{ "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 } }}Wichtige Felder
Abschnitt betitelt „Wichtige Felder“| Feld | Beschreibung |
|---|---|
notes | Die Meeting-Notizen in Markdown. null, wenn keine vorhanden sind oder die Aufnahme gesperrt ist |
download_url | Ein temporärer Download-Link. null, sofern capabilities.canDownload nicht true ist. Er läuft um download_url_expires_at ab |
media | Temporäre Wiedergabelinks. Rufen Sie die Aufnahme erneut ab, sobald expires_at abgelaufen ist |
media_type | video oder audio |
is_locked | true, wenn die Aufnahme gesperrt ist. transcription und notes sind dann null |
open_url | Die Seite der Aufnahme in der Web-App |
sharing.share_url | Der 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.
Transkript abrufen
Abschnitt betitelt „Transkript abrufen“GET /v1/recordings/:id/transcriptGibt 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.
Query-Parameter
Abschnitt betitelt „Query-Parameter“| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
start_chunk | integer | 0 | Index des ersten Chunks, der zurückgegeben wird |
limit | integer | 50 | Anzahl der Chunks (1 bis 100) |
Antwort
Abschnitt betitelt „Antwort“{ "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.
Aufnahme aktualisieren
Abschnitt betitelt „Aufnahme aktualisieren“PATCH /v1/recordings/:idBenennt eine Aufnahme um, ersetzt ihre Meeting-Notizen oder beides. Mindestens ein Feld ist erforderlich.
Request-Body
Abschnitt betitelt „Request-Body“{ "title": "New title", "notes": "## Notes\nIn Markdown"}| Feld | Beschreibung |
|---|---|
title | 1 bis 500 Zeichen |
notes | Meeting-Notizen in Markdown, bis zu 100.000 Zeichen. Ersetzt die vorhandenen Notizen |
Antwort
Abschnitt betitelt „Antwort“204 No Content mit leerem Body.
Fehler: 400 VALIDATION_ERROR, 404 RECORDING_NOT_FOUND.
Aufnahme löschen
Abschnitt betitelt „Aufnahme löschen“DELETE /v1/recordings/:idLöscht eine Aufnahme und alle ihre Daten dauerhaft: das Transkript, die Notizen und die Freigabelinks.
Antwort
Abschnitt betitelt „Antwort“204 No Content mit leerem Body.
Fehler: 404 RECORDING_NOT_FOUND.
Freigabelink erstellen
Abschnitt betitelt „Freigabelink erstellen“POST /v1/recordings/:id/share-linkErstellt 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.
Request-Body
Abschnitt betitelt „Request-Body“{ "permission": "view"}| Wert | Beschreibung |
|---|---|
view | Personen mit dem Link können die Aufnahme ansehen |
download | Personen mit dem Link können sie auch herunterladen |
Antwort
Abschnitt betitelt „Antwort“{ "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.
Status von Aufnahmen
Abschnitt betitelt „Status von Aufnahmen“| Status | Beschreibung |
|---|---|
STARTING | Die Aufnahme wird vorbereitet |
CONNECTING | Verbindung zum Meeting wird hergestellt |
WAIT_APPROVAL | Warten auf die Freigabe zur Aufnahme |
RECORDING | Die Aufnahme läuft |
STALE | Die Aufnahme hat keine Daten mehr gesendet, bevor sie abgeschlossen war |
UPLOADING | Die Aufnahme wurde beendet und wird noch hochgeladen |
PROCESSING | Das Video wird verarbeitet und kann noch nicht abgespielt werden |
MIGRATING | Das Video kann abgespielt werden, während es in den Langzeitspeicher verschoben wird |
COMPLETED | Die Aufnahme ist vollständig verarbeitet |
ERROR | Die Aufnahme ist fehlgeschlagen |