Opptak
Endepunkter for opptak, transkripsjoner og delelenker. Alle baner er på https://api.recordmeeting.com og krever en API-nøkkel. Se Autentisering.
List opp opptak
Section titled “List opp opptak”GET /v1/recordingsReturnerer en paginert liste over opptakene du har tilgang til.
Spørringsparametere
Section titled “Spørringsparametere”| Parameter | Type | Standard | Beskrivelse |
|---|---|---|---|
limit | integer | 20 | Antall resultater (1 til 100) |
offset | integer | 0 | Forskyvning for paginering |
search | string | ingen | Filtrer på tekst i tittelen |
status | string | ingen | Filtrer på status (se Opptaksstatuser) |
date_from | string | ingen | ISO 8601 dato og klokkeslett. Bare opptak opprettet på eller etter dette tidspunktet |
date_to | string | ingen | ISO 8601 dato og klokkeslett. Bare opptak opprettet på eller før dette tidspunktet |
organization_id | string | ingen | List opp opptakene i en organisasjon |
folder_id | string | ingen | List opp opptakene i en mappe |
user_id | string | ingen | Filtrer 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.
Hent opptak
Section titled “Hent opptak”GET /v1/recordings/:idReturnerer 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 } }}Viktige felter
Section titled “Viktige felter”| Felt | Beskrivelse |
|---|---|
notes | Møtenotatene i Markdown. null når det ikke finnes noen, eller når opptaket er låst |
download_url | En midlertidig nedlastingslenke. null med mindre capabilities.canDownload er true. Den utløper på download_url_expires_at |
media | Midlertidige avspillingslenker. Be om opptaket på nytt når expires_at har passert |
media_type | video eller audio |
is_locked | true når opptaket er låst. transcription og notes er da null |
open_url | Opptakets side i webapplikasjonen |
sharing.share_url | Opptakets 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.
Hent transkripsjon
Section titled “Hent transkripsjon”GET /v1/recordings/:id/transcriptReturnerer 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.
Spørringsparametere
Section titled “Spørringsparametere”| Parameter | Type | Standard | Beskrivelse |
|---|---|---|---|
start_chunk | integer | 0 | Indeksen til den første chunk-en som skal returneres |
limit | integer | 50 | Antall 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.
Oppdater opptak
Section titled “Oppdater opptak”PATCH /v1/recordings/:idGir et opptak nytt navn, erstatter møtenotatene eller begge deler. Minst ett felt er påkrevd.
Forespørselsinnhold
Section titled “Forespørselsinnhold”{ "title": "New title", "notes": "## Notes\nIn Markdown"}| Felt | Beskrivelse |
|---|---|
title | 1 til 500 tegn |
notes | Mø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.
Slett opptak
Section titled “Slett opptak”DELETE /v1/recordings/:idSletter et opptak og alle dataene permanent: transkripsjonen, notatene og delelenkene.
204 No Content med tomt innhold.
Feil: 404 RECORDING_NOT_FOUND.
Opprett delelenke
Section titled “Opprett delelenke”POST /v1/recordings/:id/share-linkOppretter 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.
Forespørselsinnhold
Section titled “Forespørselsinnhold”{ "permission": "view"}| Verdi | Beskrivelse |
|---|---|
view | Personer med lenken kan se opptaket |
download | Personer 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.
Opptaksstatuser
Section titled “Opptaksstatuser”| Status | Beskrivelse |
|---|---|
STARTING | Opptaket blir satt opp |
CONNECTING | Kobler til møtet |
WAIT_APPROVAL | Venter på godkjenning til å ta opp |
RECORDING | Opptaket pågår |
STALE | Opptaket sluttet å sende data før det var ferdig |
UPLOADING | Opptaket er stoppet og lastes fortsatt opp |
PROCESSING | Videoen behandles og kan ennå ikke spilles av |
MIGRATING | Videoen kan spilles av mens den flyttes til langtidslagring |
COMPLETED | Opptaket er ferdig behandlet |
ERROR | Opptaket mislyktes |