← Dokumentasjon

API

Saykeeper-API-et gir skript og assistenter lesetilgang til møtene dine. En nøkkel kan lese og spørre, den kan ikke opprette, endre eller slette noe.

API-nøkler

Opprett en nøkkel i appen: Innstillinger, API og MCP, API-nøkler. Gi den et navn.
Nøkkelen vises én gang. Saykeeper lagrer bare SHA-256-hashen, så en nøkkel du har mistet, kan ikke vises igjen. Opphev den og opprett en ny.
Nøkler begynner med ntb_live_. Hold dem unna URL-er, kodelagre og delte chatter.

Autorisasjon

Send nøkkelen i Authorization-headeren som et Bearer-token. Hver forespørsel ser bare møtene til nøkkeleieren.

Authorization: Bearer ntb_live_YOUR_KEY

Base-URL

https://api.saykeeper.com/v1

Endepunkter som godtar en API-nøkkel

Metode	Sti	Hva det returnerer
`GET`	`/meetings?limit=50`	Møtene dine, nyeste først (maks. 200, ?archived=true for arkiverte).
`GET`	`/meetings/search?q=budget&limit=20`	Søk i titler og transkripsjoner (filtre space_id, label_id, from, to).
`GET`	`/meetings/{id}`	Ett møte med transkripsjon (talere, tidspunkter) og AI-resultater.
`GET`	`/meetings/shared`	Møter som andre har delt med deg.
`GET`	`/meetings/report`	En rad per møte med talere, til rapporter.
`GET`	`/meetings/{id}/chat`	Spørsmål og svar som er lagret på møtet.
`POST`	`/meetings/{id}/chat`	Et spørsmål om ett møte. Body {"message":"..."}.
`GET`	`/meetings/{id}/clips`	Klipp som er klippet ut av møtet.
`GET`	`/labels`	Merkene dine.
`GET`	`/settings`	Innstillingene dine, inkludert språk for transkripsjon og notater.
`POST`	`/mcp`	MCP-server (JSON-RPC over Streamable HTTP).

Opptak, opplastinger, endring eller sletting av møter, endring av innstillinger og administrasjon av nøkler eller webhooks krever den innloggede appen og svarer 403 session_required til en nøkkel.

Eksempler

Siste møter

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

Søk

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

Ett møte med transkripsjon og notater

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

Spør om et møte

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

Feil

`400`	Ugyldig input, for eksempel en språkkode som ikke støttes (`unsupported_language`).
`401`	Manglende eller ugyldig nøkkel (`missing_bearer_token`, `invalid_api_key`).
`403`	Krever den innloggede appen (`session_required`), eller møtet er ikke ditt.
`404`	Ikke funnet.
`409`	Møtet har ingen transkripsjon ennå (`no_transcript`).
`429`	Hastighetsbegrenset (`rate_limited`). Vent og prøv igjen.

Hastighetsgrenser

Hva	Grense
Spørsmål om et møte (POST /meetings/{id}/chat)	20 / minutt
MCP ask_meeting og ask_meetings	20 / minutt

Webhooks

Saykeeper kan kalle URL-en din når et møte er klart. Legg til webhooks i Innstillinger, API og MCP. Hver levering signeres med webhook-hemmeligheten.