← Docs

API

API Saykeeper daje skryptom i asystentom dostęp do odczytu Twoich spotkań. Klucz może czytać i zadawać pytania, nie może niczego tworzyć, zmieniać ani usuwać.

Klucze API

Utwórz klucz w aplikacji: Ustawienia, API i MCP, Klucze API. Nadaj mu nazwę.
Klucz jest pokazywany raz. Saykeeper przechowuje tylko jego skrót SHA-256, więc zgubionego klucza nie da się pokazać ponownie. Unieważnij go i utwórz nowy.
Klucze zaczynają się od ntb_live_. Nie umieszczaj ich w adresach URL, repozytoriach kodu ani wspólnych czatach.

Autoryzacja

Wyślij klucz w nagłówku Authorization jako token Bearer. Każde żądanie widzi tylko spotkania właściciela klucza.

Authorization: Bearer ntb_live_YOUR_KEY

Adres bazowy

https://api.saykeeper.com/v1

Endpointy akceptujące klucz API

Metoda	Ścieżka	Co zwraca
`GET`	`/meetings?limit=50`	Twoje spotkania od najnowszego (maks. 200, ?archived=true dla zarchiwizowanych).
`GET`	`/meetings/search?q=budget&limit=20`	Wyszukiwanie w tytułach i transkrypcjach (filtry space_id, label_id, from, to).
`GET`	`/meetings/{id}`	Jedno spotkanie z transkrypcją (mówcy, czasy) i wynikami AI.
`GET`	`/meetings/shared`	Spotkania, które udostępnili Ci inni.
`GET`	`/meetings/report`	Wiersz na każde spotkanie z mówcami, do raportów.
`GET`	`/meetings/{id}/chat`	Pytania i odpowiedzi zapisane przy spotkaniu.
`POST`	`/meetings/{id}/chat`	Pytanie o jedno spotkanie. Treść {"message":"..."}.
`GET`	`/meetings/{id}/clips`	Klipy wycięte ze spotkania.
`GET`	`/labels`	Twoje etykiety.
`GET`	`/settings`	Twoje ustawienia, w tym język transkrypcji i notatek.
`POST`	`/mcp`	Serwer MCP (JSON-RPC przez Streamable HTTP).

Nagrywanie, wgrywanie, zmiana lub usuwanie spotkań, zmiany ustawień oraz zarządzanie kluczami i webhookami wymagają zalogowanej aplikacji i odpowiadają kluczowi 403 session_required.

Przykłady

Najnowsze spotkania

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

Wyszukiwanie

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

Jedno spotkanie z transkrypcją i notatkami

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

Pytanie o spotkanie

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

Błędy

`400`	Nieprawidłowe dane, na przykład nieobsługiwany kod języka (`unsupported_language`).
`401`	Brak klucza lub nieprawidłowy klucz (`missing_bearer_token`, `invalid_api_key`).
`403`	Wymaga zalogowanej aplikacji (`session_required`) albo to nie Twoje spotkanie.
`404`	Nie znaleziono.
`409`	Spotkanie nie ma jeszcze transkrypcji (`no_transcript`).
`429`	Przekroczony limit żądań (`rate_limited`). Poczekaj i spróbuj ponownie.

Limity żądań

Co	Limit
Pytania o spotkanie (POST /meetings/{id}/chat)	20 / minutę
MCP ask_meeting i ask_meetings	20 / minutę

Webhooki

Saykeeper może wywołać Twój adres URL, gdy spotkanie jest gotowe. Dodaj webhooki w Ustawieniach, API i MCP. Każde dostarczenie jest podpisane sekretem webhooka.