← Docs

API

De Saykeeper-API geeft scripts en assistenten leestoegang tot je meetings. Een sleutel kan lezen en vragen stellen, maar niets aanmaken, wijzigen of verwijderen.

API-sleutels

Maak een sleutel in de app: Instellingen, API en MCP, API-sleutels. Geef hem een naam.
De sleutel wordt één keer getoond. Saykeeper bewaart alleen de SHA-256-hash ervan, dus een kwijtgeraakte sleutel kan niet opnieuw worden getoond. Trek hem in en maak een nieuwe.
Sleutels beginnen met ntb_live_. Houd ze uit URL’s, coderepositories en gedeelde chats.

Autorisatie

Stuur de sleutel als Bearer-token in de header Authorization. Elk verzoek ziet alleen de meetings van de eigenaar van de sleutel.

Authorization: Bearer ntb_live_YOUR_KEY

Basis-URL

https://api.saykeeper.com/v1

Endpoints die een API-sleutel accepteren

Methode	Pad	Wat het teruggeeft
`GET`	`/meetings?limit=50`	Je meetings, nieuwste eerst (max. 200, ?archived=true voor gearchiveerde).
`GET`	`/meetings/search?q=budget&limit=20`	Zoeken in titels en transcripten (filters space_id, label_id, from, to).
`GET`	`/meetings/{id}`	Eén meeting met transcript (sprekers, tijden) en AI-resultaten.
`GET`	`/meetings/shared`	Meetings die anderen met je hebben gedeeld.
`GET`	`/meetings/report`	Eén regel per meeting met sprekers, voor rapporten.
`GET`	`/meetings/{id}/chat`	Vragen en antwoorden die bij de meeting zijn opgeslagen.
`POST`	`/meetings/{id}/chat`	Een vraag over één meeting. Body {"message":"..."}.
`GET`	`/meetings/{id}/clips`	Clips die uit de meeting zijn geknipt.
`GET`	`/labels`	Je labels.
`GET`	`/settings`	Je instellingen, inclusief taal van transcript en notities.
`POST`	`/mcp`	MCP-server (JSON-RPC via Streamable HTTP).

Opnemen, uploaden, meetings wijzigen of verwijderen, instellingen wijzigen en het beheren van sleutels of webhooks vereisen de ingelogde app en beantwoorden een sleutel met 403 session_required.

Voorbeelden

Laatste meetings

curl "https://api.saykeeper.com/v1/meetings?limit=5" \
  -H "Authorization: Bearer ntb_live_YOUR_KEY"

Zoeken

curl "https://api.saykeeper.com/v1/meetings/search?q=budget" \
  -H "Authorization: Bearer ntb_live_YOUR_KEY"

Eén meeting met transcript en notities

curl "https://api.saykeeper.com/v1/meetings/MEETING_ID" \
  -H "Authorization: Bearer ntb_live_YOUR_KEY"

Een vraag over een meeting stellen

curl -X POST "https://api.saykeeper.com/v1/meetings/MEETING_ID/chat" \
  -H "Authorization: Bearer ntb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"What did we agree on?"}'

Fouten

`400`	Ongeldige invoer, bijvoorbeeld een niet-ondersteunde taalcode (`unsupported_language`).
`401`	Ontbrekende of ongeldige sleutel (`missing_bearer_token`, `invalid_api_key`).
`403`	Vereist de ingelogde app (`session_required`) of niet jouw meeting.
`404`	Niet gevonden.
`409`	De meeting heeft nog geen transcript (`no_transcript`).
`429`	Limiet bereikt (`rate_limited`). Wacht en probeer het opnieuw.

Limieten

Wat	Limiet
Vragen over een meeting (POST /meetings/{id}/chat)	20 / minuut
MCP ask_meeting en ask_meetings	20 / minuut

Webhooks

Saykeeper kan je URL aanroepen wanneer een meeting klaar is. Voeg webhooks toe in Instellingen, API en MCP. Elke aanroep wordt ondertekend met het webhookgeheim.