Gå til innholdet

Opptak

Endepunkter for opptak, transkripsjoner og delelenker. Alle baner er på https://api.recordmeeting.com og krever en API-nøkkel. Se Autentisering.

GET /v1/recordings

Returnerer en paginert liste over opptakene du har tilgang til.

ParameterTypeStandardBeskrivelse
limitinteger20Antall resultater (1 til 100)
offsetinteger0Forskyvning for paginering
searchstringingenFiltrer på tekst i tittelen
statusstringingenFiltrer på status (se Opptaksstatuser)
date_fromstringingenISO 8601 dato og klokkeslett. Bare opptak opprettet på eller etter dette tidspunktet
date_tostringingenISO 8601 dato og klokkeslett. Bare opptak opprettet på eller før dette tidspunktet
organization_idstringingenList opp opptakene i en organisasjon
folder_idstringingenList opp opptakene i en mappe
user_idstringingenFiltrer på bruker. For organisasjonsadministratorer som vil ha opptakene til ett medlem
{
"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 og processing_progress kan være null. For et låst opptak er transcription_status og notes_status null.

Med organization_id får redaktører og seere bare opptakene de har lov til å se. total er da en øvre grense, og en side kan inneholde færre enn limit elementer.

Feil: 400 VALIDATION_ERROR, 403 FORBIDDEN når du ikke har tillatelse til å liste opp organisasjonens opptak.


GET /v1/recordings/:id

Returnerer fullstendige detaljer for ett opptak.

Et organisasjonsopptak returneres til alle medlemmer som har lov til å se det. Eiere og administratorer kan åpne alle opptak i organisasjonen. Redaktører og seere ser det rollen og mappene deres tillater. For et organisasjonsopptak følger is_locked, download_url og capabilities organisasjonens plan og medlemmets tilgang til funksjoner, ikke din personlige 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
}
}
}
FeltBeskrivelse
notesMøtenotatene i Markdown. null når det ikke finnes noen, eller når opptaket er låst
download_urlEn midlertidig nedlastingslenke. null med mindre capabilities.canDownload er true. Den utløper på download_url_expires_at
mediaMidlertidige avspillingslenker. Be om opptaket på nytt når expires_at har passert
media_typevideo eller audio
is_lockedtrue når opptaket er låst. transcription og notes er da null
open_urlOpptakets side i webapplikasjonen
sharing.share_urlOpptakets delelenke, eller null når det ikke har noen

Feil: 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED når organisasjonens Enterprise-abonnement ikke lenger er aktivt.


GET /v1/recordings/:id/transcript

Returnerer transkripsjonen av et opptak som segmenter, i sider med chunks.

Organisasjonsopptak følger de samme tilgangsreglene som Hent opptak. Et opptak som ennå ikke har noen transkripsjon, returnerer fortsatt 200, med "status": "not_started" og en tom segments-matrise.

ParameterTypeStandardBeskrivelse
start_chunkinteger0Indeksen til den første chunk-en som skal returneres
limitinteger50Antall chunks (1 til 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 og end er i sekunder. speaker og confidence kan være null. Så lenge has_more er true, ber du om neste side med en høyere start_chunk.

Feil: 403 RECORDING_LOCKED for et låst opptak, 403 TRANSCRIPT_NOT_AVAILABLE når transkripsjon er deaktivert for organisasjonen eller medlemmet, 403 SUBSCRIPTION_REQUIRED når full transkripsjon krever en betalt plan, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.


PATCH /v1/recordings/:id

Gir et opptak nytt navn, erstatter møtenotatene eller begge deler. Minst ett felt er påkrevd.

{
"title": "New title",
"notes": "## Notes\nIn Markdown"
}
FeltBeskrivelse
title1 til 500 tegn
notesMøtenotater i Markdown, opptil 100 000 tegn. Erstatter de eksisterende notatene

204 No Content med tomt innhold.

Feil: 400 VALIDATION_ERROR, 404 RECORDING_NOT_FOUND.


DELETE /v1/recordings/:id

Sletter et opptak og alle dataene permanent: transkripsjonen, notatene og delelenkene.

204 No Content med tomt innhold.

Feil: 404 RECORDING_NOT_FOUND.


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

Oppretter den offentlige delelenken til et opptak, eller erstatter lenken det har. Den forrige lenken slutter å virke.

For et organisasjonsopptak kan alle medlemmer som kan se opptaket, opprette lenken. Den opprettes på vegne av eieren av opptaket og bruker organisasjonens plan.

{
"permission": "view"
}
VerdiBeskrivelse
viewPersoner med lenken kan se opptaket
downloadPersoner med lenken kan også laste det ned
{
"data": {
"share_url": "https://recordmeeting.com/app/shared/abc123",
"share_token": "abc123",
"permission": "view"
}
}

Feil: 400 VALIDATION_ERROR, 400 RECORDING_NOT_READY når opptaket ennå ikke kan deles, 403 RECORDING_LOCKED, 403 SHARING_DISABLED når deling er deaktivert for organisasjonen eller medlemmet, 403 SUBSCRIPTION_REQUIRED når tillatelsen krever en betalt plan, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.


StatusBeskrivelse
STARTINGOpptaket blir satt opp
CONNECTINGKobler til møtet
WAIT_APPROVALVenter på godkjenning til å ta opp
RECORDINGOpptaket pågår
STALEOpptaket sluttet å sende data før det var ferdig
UPLOADINGOpptaket er stoppet og lastes fortsatt opp
PROCESSINGVideoen behandles og kan ennå ikke spilles av
MIGRATINGVideoen kan spilles av mens den flyttes til langtidslagring
COMPLETEDOpptaket er ferdig behandlet
ERROROpptaket mislyktes