← Docs

API

API Saykeeperu dává skriptům a asistentům přístup ke čtení vašich schůzek. Klíč může číst a ptát se, nic nevytváří, nemění ani nemaže.

API klíče

Klíč vytvoříte v aplikaci: Nastavení, API a MCP, API klíče. Pojmenujte ho.
Klíč se zobrazí jen jednou. Saykeeper ukládá pouze jeho SHA-256 otisk, ztracený klíč proto nejde znovu ukázat. Zrušte ho a vytvořte nový.
Klíče začínají na ntb_live_. Nedávejte je do URL, repozitářů ani sdílených chatů.

Autorizace

Klíč posílejte v hlavičce Authorization jako Bearer token. Každý požadavek vidí jen schůzky majitele klíče.

Authorization: Bearer ntb_live_YOUR_KEY

Základní URL

https://api.saykeeper.com/v1

Endpointy, které přijmou API klíč

Metoda	Cesta	Co vrátí
`GET`	`/meetings?limit=50`	Vaše schůzky od nejnovější (max 200, ?archived=true pro archivované).
`GET`	`/meetings/search?q=budget&limit=20`	Hledání v názvech a přepisech (filtry space_id, label_id, from, to).
`GET`	`/meetings/{id}`	Jedna schůzka s přepisem (řečníci, časy) a AI výstupy.
`GET`	`/meetings/shared`	Schůzky, které s vámi sdíleli jiní.
`GET`	`/meetings/report`	Řádek za každou schůzku s řečníky, pro reporty.
`GET`	`/meetings/{id}/chat`	Otázky a odpovědi uložené u schůzky.
`POST`	`/meetings/{id}/chat`	Otázka na jednu schůzku. Tělo {"message":"..."}.
`GET`	`/meetings/{id}/clips`	Klipy vystřižené ze schůzky.
`GET`	`/labels`	Vaše štítky.
`GET`	`/settings`	Vaše nastavení včetně jazyka přepisu a poznámek.
`POST`	`/mcp`	MCP server (JSON-RPC přes Streamable HTTP).

Nahrávání, nahrávání souborů, změna nebo mazání schůzek, změna nastavení a správa klíčů či webhooků potřebují přihlášenou aplikaci a klíči odpoví 403 session_required.

Příklady

Poslední schůzky

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

Hledání

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

Jedna schůzka s přepisem a poznámkami

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

Otázka na schůzku

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

Chyby

`400`	Špatný vstup, například nepodporovaný kód jazyka (`unsupported_language`).
`401`	Chybí nebo neplatný klíč (`missing_bearer_token`, `invalid_api_key`).
`403`	Je potřeba přihlášená aplikace (`session_required`) nebo nejde o vaši schůzku.
`404`	Nenalezeno.
`409`	Schůzka ještě nemá přepis (`no_transcript`).
`429`	Překročený limit (`rate_limited`). Počkejte a zkuste znovu.

Limity požadavků

Co	Limit
Otázky na schůzku (POST /meetings/{id}/chat)	20 / minuta
MCP ask_meeting a ask_meetings	20 / minuta

Webhooky

Saykeeper může zavolat vaši URL, když je schůzka připravená. Webhooky přidáte v nastavení, část API a MCP. Každé doručení je podepsané tajemstvím webhooku.