REST-API-Referenz

Zwei schlanke, read-only REST-Endpunkte für deine Aufnahmen — für alles Weitere (Inhalte, Aufgaben, Suche) ist der MCP-Server die primäre Schnittstelle.

Aktualisiert 4. Juli 2026

Authentifizierung

Bearer-Token

Jeder Request braucht deinen API-Key im Header: Authorization: Bearer kuno_live_…. Keys erstellst du in der Kuno-App unter Einstellungen → Entwickler.

Aufnahmen auflisten

GET /v1/recordings

Listet deine Aufnahmen, neueste zuerst. Benötigt recordings.read.

Parameter	Typ	Beschreibung
limit	integer	1–100, Standard 50.
cursor	string	Pagination-Cursor aus `nextCursor` der vorherigen Antwort.
bucket	string	`all` (Standard), `today` oder `week`.

curl "https://api.heykuno.com/v1/recordings?limit=2" \
  -H "Authorization: Bearer kuno_live_dein_key"

{
  "items": [
    {
      "id": "9c1f…",
      "title": "Baustellenbegehung Müllerstraße",
      "status": "completed",
      "createdAt": "2026-07-03T09:12:00Z"
    }
  ],
  "nextCursor": "eyJvZmZzZXQiOjJ9"
}

Eine Aufnahme abrufen

GET /v1/recordings/:id

Metadaten einer einzelnen Aufnahme (id, title, status, createdAt). Benötigt recordings.read.

Notiz-Inhalte & Aufgaben

Zusammenfassungen, Transkripte und Aufgaben liest du über den MCP-Server (POST /v1/mcp) — dort liefern die Tools get_recording und list_action_items die vollen Inhalte, scope-geprüft pro Tool.

Warum kein REST-Endpunkt für Inhalte? Der MCP-Server ist die primäre Integrationsfläche für Kuno-Daten in KI-Tools und deckt heute alle Lese-Anwendungsfälle ab. Für serverseitige Benachrichtigungen ohne Polling gibt es Webhooks; weitere REST-Endpunkte folgen, sobald sie stabil sind.

Fehlercodes

Status	Bedeutung
401	Key ungültig, abgelaufen oder widerrufen (`api_key_auth_failed`).
403	Scope fehlt oder Route für API-Keys nicht freigegeben (`api_key_route_not_permitted`).
429	Rate-Limit erreicht — mit Backoff erneut versuchen.

War das hilfreich?