← Docs

API

API Saykeepera dáva skriptom a asistentom prístup na čítanie vašich stretnutí. Kľúč môže čítať a pýtať sa, nič nevytvára, nemení ani nemaže.

API kľúče

Kľúč vytvoríte v aplikácii: Nastavenia, API a MCP, API kľúče. Pomenujte ho.
Kľúč sa zobrazí iba raz. Saykeeper ukladá len jeho SHA-256 odtlačok, stratený kľúč sa preto nedá znova ukázať. Zrušte ho a vytvorte nový.
Kľúče začínajú na ntb_live_. Nedávajte ich do URL, repozitárov ani zdieľaných chatov.

Autorizácia

Kľúč posielajte v hlavičke Authorization ako Bearer token. Každá požiadavka vidí iba stretnutia majiteľa kľúča.

Authorization: Bearer ntb_live_YOUR_KEY

Základná URL

https://api.saykeeper.com/v1

Endpointy, ktoré prijmú API kľúč

Metóda	Cesta	Čo vráti
`GET`	`/meetings?limit=50`	Vaše stretnutia od najnovšieho (max 200, ?archived=true pre archivované).
`GET`	`/meetings/search?q=budget&limit=20`	Hľadanie v názvoch a prepisoch (filtre space_id, label_id, from, to).
`GET`	`/meetings/{id}`	Jedno stretnutie s prepisom (rečníci, časy) a AI výstupmi.
`GET`	`/meetings/shared`	Stretnutia, ktoré s vami zdieľali iní.
`GET`	`/meetings/report`	Riadok za každé stretnutie s rečníkmi, pre reporty.
`GET`	`/meetings/{id}/chat`	Otázky a odpovede uložené pri stretnutí.
`POST`	`/meetings/{id}/chat`	Otázka na jedno stretnutie. Telo {"message":"..."}.
`GET`	`/meetings/{id}/clips`	Klipy vystrihnuté zo stretnutia.
`GET`	`/labels`	Vaše štítky.
`GET`	`/settings`	Vaše nastavenia vrátane jazyka prepisu a poznámok.
`POST`	`/mcp`	MCP server (JSON-RPC cez Streamable HTTP).

Nahrávanie, nahrávanie súborov, zmena alebo mazanie stretnutí, zmena nastavení a správa kľúčov či webhookov potrebujú prihlásenú aplikáciu a kľúču odpovedia 403 session_required.

Príklady

Posledné stretnutia

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

Hľadanie

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

Jedno stretnutie s prepisom a poznámkami

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

Otázka na stretnutie

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`	Zlý vstup, napríklad nepodporovaný kód jazyka (`unsupported_language`).
`401`	Chýba alebo neplatný kľúč (`missing_bearer_token`, `invalid_api_key`).
`403`	Treba prihlásenú aplikáciu (`session_required`) alebo nejde o vaše stretnutie.
`404`	Nenájdené.
`409`	Stretnutie ešte nemá prepis (`no_transcript`).
`429`	Prekročený limit (`rate_limited`). Počkajte a skúste znova.

Limity požiadaviek

Čo	Limit
Otázky na stretnutie (POST /meetings/{id}/chat)	20 / minúta
MCP ask_meeting a ask_meetings	20 / minúta

Webhooky

Saykeeper môže zavolať vašu URL, keď je stretnutie pripravené. Webhooky pridáte v nastaveniach, časť API a MCP. Každé doručenie je podpísané tajomstvom webhooku.