Hoppa till innehåll

Upptagningar

Slutpunkter för upptagningar, transkript och delningslänkar. Alla vägar finns på https://api.recordmeeting.com och kräver en API-nyckel. Se Authentication.

GET /v1/recordings

Returnerar en paginerad lista över upptagningar du har tillgång till.

ParameterTypStandardBeskrivning
limitinteger20Antal resultat (1 till 100)
offsetinteger0Sidopaginering
searchstringnoneFiltrera efter text i titeln
statusstringnoneFiltrera efter status (se Recording statuses)
date_fromstringnoneISO 8601 datum/tid. Endast upptagningar skapade på eller efter detta datum
date_tostringnoneISO 8601 datum/tid. Endast upptagningar skapade på eller före detta datum
organization_idstringnoneLista upptagningar för en viss organisation
folder_idstringnoneLista upptagningar för en mapp
user_idstringnoneFiltrera efter användare. För administratörer i en organisation som vill se en specifik medlems upptagningar
{
"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 och processing_progress kan vara null. För en låst upptagning är transcription_status och notes_status null.

Med organization_id får Editors och Viewers endast de upptagningar de har behörighet att se. total är då en övre gräns, och en sida kan innehålla färre objekt än limit.

Fel: 400 VALIDATION_ERROR, 403 FORBIDDEN när du inte får lista upptagningarna för den organisationen.


GET /v1/recordings/:id

Returnerar fullständig detaljer för en enskild upptagning.

En upptagning som tillhör en organisation returneras till alla medlemmar som får se den. Owners och Admins kan öppna alla upptagningar i sin organisation. Editors och Viewers ser det som deras roll och mappbehörigheter tillåter. För en organisationsupptagning beror is_locked, download_url och capabilities på organisationens plan och medlemmens funktionstillgång, inte din personliga plan.

{
"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
}
}
}
FältBeskrivning
notesMötets anteckningar i Markdown. null när det inte finns några eller när upptagningen är låst
download_urlEn temporär nedladdningslänk. null om capabilities.canDownload inte är true. Den går ut vid download_url_expires_at
mediaTemporära uppspelningslänkar. Begär upptagningen igen efter att expires_at har passerat
media_typevideo eller audio
is_lockedtrue när upptagningen är låst. Då är transcription och notes null
open_urlUpptagningens sida i webbapplikationen
sharing.share_urlUpptagningens delningslänk, eller null om den inte har en sådan

Fel: 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED när organisationens Enterprise-prenumeration inte längre är aktiv.


GET /v1/recordings/:id/transcript

Returnerar transkriptet för en upptagning uppdelat i segment i sidor med block.

Upptagningar som tillhör en organisation följer samma behörighetsregler som Hämta upptagning. En upptagning som ännu inte har transkript returnerar fortfarande 200, med "status": "not_started" och ett tomt segments-array.

ParameterTypStandardBeskrivning
start_chunkinteger0Index för det första blocket som ska returneras
limitinteger50Antal block (1 till 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 och end är i sekunder. speaker och confidence kan vara null. Så länge has_more är true ska du begära nästa sida med ett högre start_chunk.

Fel: 403 RECORDING_LOCKED för en låst upptagning, 403 TRANSCRIPT_NOT_AVAILABLE när transkript är inaktiverat för organisationen eller medlemmaren, 403 SUBSCRIPTION_REQUIRED när fullständigt transkript kräver en betald plan, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.


PATCH /v1/recordings/:id

Byter namn på en upptagning eller ersätter dess mötesanteckningar, eller båda. Minst ett fält måste specificeras.

{
"title": "New title",
"notes": "## Notes\nIn Markdown"
}
FältBeskrivning
title1 till 500 tecken
notesMötets anteckningar i Markdown, upp till 100 000 tecken. Ersätter befintliga anteckningar

204 No Content med en tom kropp.

Fel: 400 VALIDATION_ERROR, 404 RECORDING_NOT_FOUND.


DELETE /v1/recordings/:id

Rader permanent en upptagning och all dess data: transkriptet, anteckningarna och delningslänkarna.

204 No Content med en tom kropp.

Fel: 404 RECORDING_NOT_FOUND.


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

Skapar den offentliga delningslänken till en upptagning eller ersätter den befintliga. Den tidigare länken slutar fungera.

För en organisationsupptagning kan vilken medlem som helst som har behörighet att se upptagningen skapa länken. Den skapas å upptagningens ägares vägnar och använder organisationens plan.

{
"permission": "view"
}
VärdeBeskrivning
viewPersoner med länken kan titta på upptagningen
downloadPersoner med länken kan också ladda ner den
{
"data": {
"share_url": "https://recordmeeting.com/app/shared/abc123",
"share_token": "abc123",
"permission": "view"
}
}

Fel: 400 VALIDATION_ERROR, 400 RECORDING_NOT_READY när upptagningen ännu inte kan delas, 403 RECORDING_LOCKED, 403 SHARING_DISABLED när delning är inaktiverad för organisationen eller medlemmaren, 403 SUBSCRIPTION_REQUIRED när behörigheten kräver en betald plan, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.


StatusBeskrivning
STARTINGUpptagningen förbereds
CONNECTINGAnslutning till mötet
WAIT_APPROVALVäntar på godkännande för att spelas in
RECORDINGSpelas in för tillfället
STALEUpptagningen slutade sända data innan den var klar
UPLOADINGUpptagningen har stoppats och laddas fortfarande upp
PROCESSINGVideon bearbetas och kan ännu inte spelas upp
MIGRATINGVideon kan spelas upp medan den flyttas till långtidslagring
COMPLETEDUpptagningen är fullständigt bearbetad
ERRORUpptagningen misslyckades