← Doku

API

Die Saykeeper-API gibt Skripten und Assistenten Lesezugriff auf Ihre Meetings. Ein Schlüssel kann lesen und fragen, aber nichts erstellen, ändern oder löschen.

API-Schlüssel

Erstellen Sie einen Schlüssel in der App: Einstellungen, API und MCP, API-Schlüssel. Geben Sie ihm einen Namen.
Der Schlüssel wird einmal angezeigt. Saykeeper speichert nur seinen SHA-256-Hash, ein verlorener Schlüssel kann daher nicht erneut angezeigt werden. Widerrufen Sie ihn und erstellen Sie einen neuen.
Schlüssel beginnen mit ntb_live_. Halten Sie sie aus URLs, Code-Repositories und geteilten Chats heraus.

Autorisierung

Senden Sie den Schlüssel im Header Authorization als Bearer-Token. Jede Anfrage sieht nur die Meetings des Schlüsselinhabers.

Authorization: Bearer ntb_live_YOUR_KEY

Basis-URL

https://api.saykeeper.com/v1

Endpunkte, die einen API-Schlüssel akzeptieren

Methode	Pfad	Was zurückkommt
`GET`	`/meetings?limit=50`	Ihre Meetings, neueste zuerst (max. 200, ?archived=true für archivierte).
`GET`	`/meetings/search?q=budget&limit=20`	Suche in Titeln und Transkripten (Filter space_id, label_id, from, to).
`GET`	`/meetings/{id}`	Ein Meeting mit Transkript (Sprecher, Zeiten) und KI-Ergebnissen.
`GET`	`/meetings/shared`	Meetings, die andere mit Ihnen geteilt haben.
`GET`	`/meetings/report`	Eine Zeile pro Meeting mit Sprechern, für Berichte.
`GET`	`/meetings/{id}/chat`	Fragen und Antworten, die beim Meeting gespeichert sind.
`POST`	`/meetings/{id}/chat`	Eine Frage zu einem Meeting. Body {"message":"..."}.
`GET`	`/meetings/{id}/clips`	Clips, die aus dem Meeting herausgeschnitten wurden.
`GET`	`/labels`	Ihre Labels.
`GET`	`/settings`	Ihre Einstellungen, einschließlich Sprache von Transkript und Notizen.
`POST`	`/mcp`	MCP-Server (JSON-RPC über Streamable HTTP).

Aufnahme, Uploads, Ändern oder Löschen von Meetings, Änderungen an Einstellungen sowie die Verwaltung von Schlüsseln und Webhooks erfordern die angemeldete App und beantworten einen Schlüssel mit 403 session_required.

Beispiele

Neueste Meetings

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

Suche

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

Ein Meeting mit Transkript und Notizen

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

Frage zu einem Meeting

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

Fehler

`400`	Ungültige Eingabe, zum Beispiel ein nicht unterstützter Sprachcode (`unsupported_language`).
`401`	Fehlender oder ungültiger Schlüssel (`missing_bearer_token`, `invalid_api_key`).
`403`	Erfordert die angemeldete App (`session_required`) oder es ist nicht Ihr Meeting.
`404`	Nicht gefunden.
`409`	Das Meeting hat noch kein Transkript (`no_transcript`).
`429`	Ratenlimit erreicht (`rate_limited`). Warten Sie und versuchen Sie es erneut.

Ratenlimits

Was	Limit
Fragen zu einem Meeting (POST /meetings/{id}/chat)	20 / Minute
MCP ask_meeting und ask_meetings	20 / Minute

Webhooks

Saykeeper kann Ihre URL aufrufen, wenn ein Meeting fertig ist. Fügen Sie Webhooks unter Einstellungen, API und MCP hinzu. Jede Zustellung wird mit dem Webhook-Secret signiert.