← Docs

API

Saykeeper-API:et ger skript och assistenter läsåtkomst till dina möten. En nyckel kan läsa och fråga, den kan inte skapa, ändra eller radera något.

API-nycklar

Skapa en nyckel i appen: Inställningar, API och MCP, API-nycklar. Ge den ett namn.
Nyckeln visas en gång. Saykeeper lagrar bara dess SHA-256-hash, så en förlorad nyckel kan inte visas igen. Återkalla den och skapa en ny.
Nycklar börjar med ntb_live_. Håll dem utanför URL:er, kodförråd och delade chattar.

Auktorisering

Skicka nyckeln i rubriken Authorization som en Bearer-token. Varje anrop ser bara nyckelägarens möten.

Authorization: Bearer ntb_live_YOUR_KEY

Bas-URL

https://api.saykeeper.com/v1

Endpoints som accepterar en API-nyckel

Metod	Sökväg	Vad den returnerar
`GET`	`/meetings?limit=50`	Dina möten, de senaste först (max 200, ?archived=true för arkiverade).
`GET`	`/meetings/search?q=budget&limit=20`	Sök i titlar och transkriptioner (filter space_id, label_id, from, to).
`GET`	`/meetings/{id}`	Ett möte med transkription (talare, tider) och AI-resultat.
`GET`	`/meetings/shared`	Möten som andra har delat med dig.
`GET`	`/meetings/report`	En rad per möte med talare, för rapporter.
`GET`	`/meetings/{id}/chat`	Frågor och svar som sparats vid mötet.
`POST`	`/meetings/{id}/chat`	En fråga om ett möte. Innehåll {"message":"..."}.
`GET`	`/meetings/{id}/clips`	Klipp som klippts ut ur mötet.
`GET`	`/labels`	Dina etiketter.
`GET`	`/settings`	Dina inställningar, inklusive språk för transkription och anteckningar.
`POST`	`/mcp`	MCP-server (JSON-RPC över Streamable HTTP).

Inspelning, uppladdningar, ändring eller radering av möten, ändringar av inställningar och hantering av nycklar eller webhooks kräver den inloggade appen och besvaras med 403 session_required för en nyckel.

Exempel

Senaste mötena

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 transkription och anteckningar

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

Fråga om ett 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?"}'

Fel

`400`	Ogiltig indata, till exempel en språkkod som inte stöds (`unsupported_language`).
`401`	Nyckel saknas eller är ogiltig (`missing_bearer_token`, `invalid_api_key`).
`403`	Kräver den inloggade appen (`session_required`) eller så är det inte ditt möte.
`404`	Hittades inte.
`409`	Mötet har ännu ingen transkription (`no_transcript`).
`429`	Hastighetsbegränsad (`rate_limited`). Vänta och försök igen.

Hastighetsbegränsningar

Vad	Gräns
Frågor om ett möte (POST /meetings/{id}/chat)	20 / minut
MCP ask_meeting och ask_meetings	20 / minut

Webhooks

Saykeeper kan anropa din URL när ett möte är klart. Lägg till webhooks i Inställningar, API och MCP. Varje leverans signeras med webhookens hemlighet.