Help Center

Wave Developer API

Maak een token met beperkte rechten aan en lees, werk bij of importeer Wave-sessies, transcripten en actiepunten vanuit je eigen code, met zoekfunctie, bulkexport en webhooks.

Laatst bijgewerkt:

De Wave AI Developer API is een REST API over je eigen opnames. Richt je code op https://api.wave.co/v1 met een token die je zelf aanmaakt in Wave, en je kunt sessies opsommen, samenvattingen en transcripten lezen, zoeken op betekenis, audio downloaden, opnames importeren, titels, samenvattingen en actiepunten bijwerken, en een webhook ontvangen zodra een opname klaar is met verwerken.

Het is gratis op elk Wave-abonnement en reikt nooit verder dan je eigen account.

Een token aanmaken

Ga in de Wave-webapp op app.wave.co naar Settings → Developers ("Instellingen → Ontwikkelaars") en open API tokens and webhooks — of ga direct naar app.wave.co/settings/integrations/api.

Klik onder API tokens op Create token.

Geef de token een Token name die je later herkent, vink de Permissions aan die nodig zijn, en klik op Create token. Eén token per integratie is veel makkelijker te beheren dan één gedeelde token.

Kopieer de token uit het dialoogvenster Token created. Wave toont hem maar één keer: Copy this token now. You will not be able to see it again. ("Kopieer deze token nu. Je kunt hem hierna niet meer zien.")

Stuur hem als bearer token mee bij elk verzoek:

curl -H "Authorization: Bearer wave_api_xxx..." \
  https://api.wave.co/v1/sessions

De lijst met tokens toont per token de naam, het wave_api_-voorvoegsel, de rechten, en wanneer de token is aangemaakt, voor het laatst gebruikt en verloopt. Het prullenbakicoon vraagt Revoke this token? ("Deze token intrekken?") — kies Revoke token en het effect is onmiddellijk; alles dat die token gebruikt krijgt vanaf dan een 401.

API-tokens verlopen één jaar na aanmaak. Als een integratie die maandenlang goed werkte plotseling 401 invalid_token teruggeeft, controleer dan de Expires-datum ("Verloopt") in de tokenlijst en maak een nieuwe token aan.

Rechten

Rechten gelden per token. Geef zo min mogelijk rechten, net genoeg om de taak uit te voeren.

RechtWat het toelaat
Read sessionsSessies opsommen en openen, statistieken, personen, bulkexport
Write sessions and action itemsTitel, notities, samenvatting, tags, favoriet, actiepunten bijwerken
Delete sessionsEen sessie permanent verwijderen
Search sessionsSemantisch zoeken doorheen je bibliotheek
Read transcriptsVolledige transcripten met sprekerssegmenten
Access mediaOndertekende downloadlinks voor audio en video
Read accountAccountinformatie en abonnementsstatus
Manage webhooksWebhook-eindpunten registreren en beheren
Read event feedDe event feed ophalen en bevestigen
Read foldersMappen opsommen en openen (Read sessions werkt ook)
Manage foldersMappen aanmaken, hernoemen, van kleur veranderen, vastpinnen, herordenen en verwijderen, en sessies toevoegen of verwijderen
Share sessions and manage accessJe sessies delen met andere Wave-gebruikers, zien wie toegang heeft, en mensen verwijderen
Import recordings (uses your import allowance)Audio en video importeren in Wave via link of upload. Nooit inbegrepen bij het schrijfrecht; apart aanvinken

Roep je een endpoint aan zonder het bijbehorende recht, dan krijg je een 403 die aangeeft wat ontbreekt.

Je gegevens lezen

  • GET /v1/sessions — nieuwste eerst, cursor-gepagineerd, filterbaar op type, since, folder, tag en person. Alleen sessies die klaar zijn met verwerken worden teruggegeven. folder accepteert een id, een naam of een pad Parent/Child; een bovenliggende map omvat ook de sessies in zijn submappen, tenzij je include_subfolders=false meegeeft.
  • GET /v1/sessions/:id — titel, duur, markdown-samenvatting, notities, tags, favoriet. Telefoongesprekken bevatten ook richting en nummers.
  • GET /v1/sessions/:id/transcript — een plat transcript als string, plus getimede, van sprekerslabel voorziene segmenten.
  • GET /v1/sessions/:id/action-items — gestructureerde actiepunten en een versienummer.
  • GET /v1/sessions/:id/media — ondertekende audio- en video-URL's, een uur geldig.
  • POST /v1/sessions/search — semantisch zoeken, tot 50 resultaten, optionele tagfilters.
  • POST /v1/sessions/bulk — tot 50 sessies in één aanroep, met samenvattingen en transcripten. De snelste manier om achterstallige data op te halen.
  • GET /v1/folders, GET /v1/folders/:id, GET /v1/sessions/stats — mappen, en totalen per type en platform. Mappen kunnen één niveau diep genest worden: elke map heeft een parent_id (null op het hoogste niveau), en GET /v1/folders?parent_id=none of ?parent_id={id} toont één niveau.

Personen

Personen zijn de stemmen die je hebt opgeslagen als Voice IDs. Hiervoor volstaat het recht Read Sessions, en ze zijn alleen-lezen.

  • GET /v1/people — iedereen van wie je een stem hebt opgeslagen, met hoeveel opnames ze bevatten en wanneer ze voor het laatst gehoord werden. Je eigen stem is gemarkeerd als is_me en staat vooraan.
  • GET /v1/people/:id/sessions — de opnames van één persoon, nieuwste eerst, cursor-gepagineerd, filterbaar op type, from en to. Elke rij toont hoe lang die persoon sprak, de naam die hij of zij heeft in dat transcript, en de drie langste regels. Gebruik me als id voor je eigen stem.
  • GET /v1/sessions?person=:id — de gewone sessielijst, beperkt tot de opnames waarin die persoon voorkomt.

Stemfragmenten worden nooit teruggegeven, en volledige transcripten ook niet; haal een transcript apart op als je meer nodig hebt dan de drie regels. Als je twee Voice ID's hebt samengevoegd in Wave, geeft de oude id een 404 terug waarvan merged_into aangeeft welke id je moet gebruiken. Zolang Wave de personen van een account nog aan het indexeren is, dekken de tellingen enkel de 1.000 nieuwste opnames en bevatten de antwoorden partial: true.

Terugschrijven

PATCH /v1/sessions/:id stelt titel, notities, samenvatting (markdown), tags, favoriet en actiepunten in. Voor actiepunten: lees ze eerst en stuur de versie terug die je hebt ontvangen — een gelijktijdige wijziging in de Wave-app wordt dan geweigerd in plaats van stilzwijgend overschreven. POST /v1/folders, PATCH /v1/folders/:id, DELETE /v1/folders/:id, en de endpoints voor mapvermeldingen (POST en DELETE /v1/sessions/:id/folders/:folderId) organiseren sessies. Mappen zijn niet exclusief, dus een sessie kan in meerdere mappen zitten, en een map verwijderen verwijdert de sessies erin niet. Geef parent_id mee aan POST /v1/folders om een submap te maken, of aan PATCH /v1/folders/:id om een map te verplaatsen (null zet hem terug op het hoogste niveau). De bovenliggende map moet op het hoogste niveau staan, en een map met submappen kan niet in een andere map worden geplaatst; beide geven een 400 invalid_parent. Verwijder je een bovenliggende map, dan gaan de submappen naar het hoogste niveau.

DELETE /v1/sessions/:id is permanent en is niet hetzelfde als verwijderen in de app. Beschouw het als onherstelbaar.

Opnames importeren

POST /v1/sessions/import maakt een sessie aan vanuit een audio- of videobestand. Wave transcribeert en vat het precies zo samen als een bestand dat in de app is geïmporteerd. Hiervoor is het recht Import recordings (uses your import allowance) nodig (sessions:import). Stuur een van de volgende mee:

  • source_url: een openbare https-link naar het bestand zelf. Wave downloadt het (tot 2 GiB) en antwoordt met 202 en status: "fetching".
  • upload: met een content_type (en optioneel filename en size_bytes). Wave antwoordt met 201 en een ondertekende upload.url. Stuur het bestand daarnaartoe met PUT binnen 15 minuten, met exact de upload.headers die je hebt gekregen (tot 5 GiB). De verwerking start vanzelf zodra de upload klaar is.

Je kunt ook title, notes, tags, language en recorded_at meegeven. Vraag daarna GET /v1/sessions/:id op voor processing_status, of luister naar de webhook Session completed.

curl -X POST https://api.wave.co/v1/sessions/import \
  -H "Authorization: Bearer wave_api_xxx..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: standup-2026-10-21" \
  -d '{"source_url": "https://example.com/standup.mp3", "title": "Daily standup"}'

Stuur een header Idempotency-Key mee om herhaalde pogingen veilig te maken: dezelfde sleutel en body opnieuw sturen geeft de oorspronkelijke sessie terug in plaats van een tweede import.

Ondersteunde formaten: MP3, M4A, WAV, AAC, FLAC, OGG, OPUS, WebM, MP4, MOV, AIFF, AMR, WMA, 3GP, CAF, MPEG en MPEG-TS. Imports delen het importquotum van je account met de Wave-apps: 12 per uur en 20 per dag (40 en 100 voor betalende klanten; minder voor accounts die minder dan twee dagen oud zijn). Overschrijd je dat, dan krijg je een 429 import_rate_limited, en een gratis abonnement zonder resterende minuten krijgt een 403 subscription_required.

Delen

Een token handelt namens jou, dus kan hij de sessies lezen die andere Wave-gebruikers met jou hebben gedeeld, met de hierboven genoemde rechten. GET /v1/shared-sessions somt ze op, en GET /v1/shared-sessions/{owner_id}/{id} plus /transcript, /action-items en /media lezen er één. Voeg include=shared toe aan GET /v1/sessions om ze op te nemen in je eigen lijst; elke rij bevat dan access (owner of shared) en, bij gedeelde rijen, de eigenaar. Gedeelde rijen kunnen niet gefilterd worden op map of tag, gedeelde sessies zijn alleen-lezen, en zoeken dekt alleen je eigen sessies.

Met Share sessions and manage access kan een token je eigen sessies delen: /v1/sessions/{id}/sharing toont wie toegang heeft, en de routes eronder maken een uitnodigingslink aan, versturen e-mailuitnodigingen (tot 10 adressen per aanroep), annuleren een openstaande uitnodiging, verwijderen iemand, of resetten de link. Zie Sessies delen vanuit Claude, ChatGPT, de API en de CLI voor de volledige lijst en de limieten.

Snelheidslimieten

Elke token krijgt 60 verzoeken per minuut en 10.000 verzoeken per dag. Antwoorden bevatten X-RateLimit-Limit, X-RateLimit-Remaining en X-RateLimit-Reset, en een 429 bevat Retry-After — wacht dan even in plaats van meteen opnieuw te proberen.

Dezelfde zoekopdracht meer dan tien keer per uur herhalen geeft ook een 429. Identieke zoekopdrachten geven identieke resultaten, gebruik dus webhooks of GET /v1/sessions?since= om te zien wat er nieuw is.

Webhooks

In plaats van te pollen, kun je Wave naar jou laten POST'en. Klik in de sectie Webhooks op Add webhook, voer een Endpoint URL in (alleen HTTPS, en URL's die naar private adressen verwijzen worden geweigerd), kies je Events, en klik op Create webhook. Het Signing secret wordt één keer getoond — bewaar het dan meteen. Je kunt maximaal vijf webhooks hebben.

De events: Session completed (eenmaal verstuurd, nadat de verwerking is afgerond en de samenvatting opvraagbaar is; de meest gevraagde door integraties), Session updated, Action items updated (verstuurd wanneer actiepunten via de API worden geschreven of bewerkt), en Session deleted. Je kunt een webhook ook vanuit je eigen code registreren met POST /v1/webhooks (of wave webhooks create).

Session completed kan meer bevatten dan alleen de samenvatting. Wanneer je een webhook aanmaakt met POST /v1/webhooks, of er een wijzigt met PATCH /v1/webhooks/:id, geef je een include-object mee:

{ "include": { "summary": true, "transcript": true, "action_items": true } }

summary staat standaard aan; transcript en action_items staan standaard uit. Voor het meesturen van het transcript is een token met Read transcripts nodig. Zeer lange transcripten worden afgekapt op 200.000 tekens en gemarkeerd met transcript_truncated: true; haal de rest op via GET /v1/sessions/:id/transcript. Actiepunten zijn degene die bij de sessie horen op het moment dat ze is voltooid; voegt Wave er even later meer toe, dan krijg je een event Action items updated. Andere events bevatten altijd de gewone sessie.

Elke aflevering is ondertekend met jouw secret en komt binnen met de headers X-Wave-Webhook-Id, X-Wave-Webhook-Timestamp en X-Wave-Webhook-Signature. Controleer de handtekening voordat je een payload vertrouwt; de exacte string om te ondertekenen staat in de API-referentie.

Wave garandeert geen eenmalige aflevering per event. Een aflevering die een time-out krijgt (10 seconden) of een niet-2xx-antwoord teruggeeft, wordt tot drie keer opnieuw geprobeerd met een korte backoff — ongeveer 10 seconden, dan een minuut, dan vijf minuten — en hetzelfde event kan dus terecht meer dan eens aankomen. Maak je handler idempotent: gebruik X-Wave-Webhook-Id als sleutel, negeer een id die je al hebt verwerkt, en geef snel een 2xx terug. Een endpoint dat langer dan dat venster onbereikbaar is, verliest de events die het heeft gemist; gebruik dan de event feed hieronder om bij te komen.

Faalt een endpoint tien keer na elkaar, dan markeert Wave het als Turned off automatically ("Automatisch uitgeschakeld") en stopt met versturen. Los het endpoint op en kies dan Turn webhook back on ("Webhook weer inschakelen") op de rij van de webhook.

Geen server? Gebruik de event feed

Kun je geen openbare URL hosten, poll dan in plaats daarvan. GET /v1/events geeft events terug na een cursor die Wave per token bijhoudt, en POST /v1/events/ack zet die cursor vooruit zodra je ze hebt verwerkt, zodat een script dat opnieuw opstart niet alles opnieuw afspeelt. Pagina's tellen standaard 50 items en maximaal 200, en de feed bevat ook wijzigingen aan actiepunten. Hiervoor is het recht Read event feed nodig.

De Wave CLI verpakt dit in wave events tail als je liever geen polling-lus schrijft.

Veelgestelde vragen

Was dit artikel nuttig?

Nog hulp nodig?

Mail de support

Op deze pagina