← Docs

API

Saykeeper-API’et giver scripts og assistenter læseadgang til dine møder. En nøgle kan læse og spørge, men ikke oprette, ændre eller slette noget.

API-nøgler

Opret en nøgle i appen: Indstillinger, API og MCP, API-nøgler. Giv den et navn.
Nøglen vises kun én gang. Saykeeper gemmer kun dens SHA-256-hash, så en mistet nøgle kan ikke vises igen. Tilbagekald den, og opret en ny.
Nøgler begynder med ntb_live_. Hold dem ude af URL’er, kodelagre og delte chats.

Autorisation

Send nøglen i headeren Authorization som et Bearer-token. Hver forespørgsel ser kun nøgleejerens møder.

Authorization: Bearer ntb_live_YOUR_KEY

Basis-URL

https://api.saykeeper.com/v1

Endpoints, der accepterer en API-nøgle

Metode	Sti	Hvad den returnerer
`GET`	`/meetings?limit=50`	Dine møder, de nyeste først (maks. 200, ?archived=true for arkiverede).
`GET`	`/meetings/search?q=budget&limit=20`	Søgning i titler og udskrifter (filtre space_id, label_id, from, to).
`GET`	`/meetings/{id}`	Ét møde med udskrift (talere, tider) og AI-resultater.
`GET`	`/meetings/shared`	Møder, som andre har delt med dig.
`GET`	`/meetings/report`	En række pr. møde med talere, til rapporter.
`GET`	`/meetings/{id}/chat`	Spørgsmål og svar, der er gemt ved mødet.
`POST`	`/meetings/{id}/chat`	Et spørgsmål til ét møde. Body {"message":"..."}.
`GET`	`/meetings/{id}/clips`	Klip, der er skåret ud af mødet.
`GET`	`/labels`	Dine labels.
`GET`	`/settings`	Dine indstillinger, herunder sprog for udskrift og noter.
`POST`	`/mcp`	MCP-server (JSON-RPC over Streamable HTTP).

Optagelse, uploads, ændring eller sletning af møder, ændringer af indstillinger og administration af nøgler eller webhooks kræver den loggede ind app og besvarer en nøgle med 403 session_required.

Eksempler

Seneste møder

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

Søgning

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

Ét møde med udskrift og noter

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

Spørg om et møde

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?"}'

Fejl

`400`	Ugyldigt input, for eksempel en sprogkode, der ikke understøttes (`unsupported_language`).
`401`	Manglende eller ugyldig nøgle (`missing_bearer_token`, `invalid_api_key`).
`403`	Kræver den loggede ind app (`session_required`), eller det er ikke dit møde.
`404`	Ikke fundet.
`409`	Mødet har endnu ingen udskrift (`no_transcript`).
`429`	Hastighedsbegrænset (`rate_limited`). Vent, og prøv igen.

Hastighedsbegrænsninger

Hvad	Grænse
Spørgsmål om et møde (POST /meetings/{id}/chat)	20 / minut
MCP ask_meeting og ask_meetings	20 / minut

Webhooks

Saykeeper kan kalde din URL, når et møde er klar. Tilføj webhooks under Indstillinger, API og MCP. Hver levering signeres med webhookens hemmelighed.