Erste Schritte & API-Keys
Der Zugang zur Kuno-API läuft über persönliche, read-only API-Keys, die du direkt in der Kuno-App erstellst. So kommst du in fünf Minuten zum ersten Request.
API-Key erstellen
Öffne in der Kuno-App Einstellungen → Entwickler → API-Keys und tippe auf Neuen Key erstellen. Du vergibst einen Namen, wählst die Scopes und optional ein Ablaufdatum.
Der Key wird genau einmal angezeigt. Kuno speichert nur einen Hash. Kopiere den Key direkt in deinen Passwort-Manager — danach lässt er sich nicht mehr abrufen, nur rotieren.
Keys haben das Format kuno_live_… und gelten für dein Konto: Sie sehen
genau die Aufnahmen, die du auch in der App siehst — nie die anderer Nutzer.
Scopes
| Scope | Zugriff |
|---|---|
| recordings.read | Aufnahmen auflisten und Metadaten abrufen (Titel, Status, Datum). |
| summaries.read | Notiz-Inhalte lesen: Zusammenfassung, Transkript, Kernpunkte. |
| actions.read | Aufgaben (Action Items) über alle Aufnahmen hinweg auflisten. |
Alle Scopes sind read-only — Schreiben, Ändern oder Löschen über die API ist bewusst nicht möglich.
Erster Request
Authentifiziert wird per Bearer-Token im Authorization-Header:
curl https://api.heykuno.com/v1/recordings?limit=5 \
-H "Authorization: Bearer kuno_live_dein_key"Die Antwort ist JSON mit deinen neuesten Aufnahmen. Alle Endpunkte stehen in der REST-API-Referenz; für KI-Assistenten wie Claude oder Cursor ist der MCP-Server der einfachere Weg.
Key rotieren oder widerrufen
In Einstellungen → Entwickler → API-Keys kannst du jeden Key jederzeit rotieren (alter Key wird ungültig, du bekommst sofort einen neuen) oder widerrufen (Key wird sofort ungültig). Ein kompromittierter Key ist damit in Sekunden aus dem Verkehr.