Die REST-API ist dieselbe Schnittstelle, mit der die demi-App, die CLI und der MCP-Server arbeiten. Was die App kann, kann deine Integration auch, mit denselben Rechten.
- Basis-URL
https://api.godemi.com- Format
- JSON über HTTPS, Pfade unter
/v1/ - Vertrag
- OpenAPI 3.1. Das Dokument bekommst du auf Anfrage von uns.
- Anmeldung
- API-Schlüssel oder OAuth-Token als Bearer-Token
- Echtzeit
- Server-Sent Events unter
/v1/stream/
Erste Anfrage
curl https://api.godemi.com/v1/me/profile \ -H "Authorization: Bearer <your-api-key>"Ohne gültiges Token antwortet die API mit 401. Wie du einen Schlüssel anlegst: Anmeldung und Schlüssel.
Mandanten
Jede Anfrage läuft in genau einem Mandanten. Ein API-Schlüssel nutzt den, in dem er angelegt wurde. Einen anderen Mandanten, in dem du Mitglied bist, wählst du mit dem Header x-demi-tenant-id:
curl https://api.godemi.com/v1/tenants/current \ -H "Authorization: Bearer <your-api-key>" \ -H "x-demi-tenant-id: <workspace-id>"Ein Token, das für mehrere Mandanten gilt, braucht den Header zum Schreiben. Fehlt er, antwortet die API mit 422 und dem Code TENANT_NOT_SELECTED.
Was die API abdeckt
- Seiten und Blöcke: lesen, suchen, anlegen, ändern, verschieben, veröffentlichen, exportieren
- Links, Dateien und Uploads, Kommentare, Versionen
- Mitglieder, Organisationseinheiten, Rollen und Rechte
- Agenten und ihre Läufe
- Lead-Report-Aufträge
- Dein Profil: Schlüssel, zweiter Faktor, Sitzungen
- Ereignisse in Echtzeit über Server-Sent Events
Wichtige Endpunkte
/v1/me/profile/v1/docsq, seitenweise mit cursor und limit (bis 200)./v1/docs/grep/v1/docs/{id}format=ddmd liefert sie als Markdown./v1/docs/v1/docs/{id}/v1/agents/v1/runsGET /v1/runs/{id} zeigt seinen Stand./v1/stream/eventsSeiten lesen und suchen
curl "https://api.godemi.com/v1/docs?q=Angebot&limit=20" \ -H "Authorization: Bearer <your-api-key>"curl "https://api.godemi.com/v1/docs/grep?q=Lieferzeit" \ -H "Authorization: Bearer <your-api-key>"curl "https://api.godemi.com/v1/docs/<page-id>?format=ddmd" \ -H "Authorization: Bearer <your-api-key>"Listen kommen seitenweise. Gib den cursor aus der letzten Antwort mit, um die nächste Seite zu holen.
Ereignisse in Echtzeit
curl -N "https://api.godemi.com/v1/stream/events?docs=<page-id>" \ -H "Authorization: Bearer <your-api-key>" \ -H "Accept: text/event-stream"Die Verbindung bleibt offen, und jedes Ereignis kommt als eigene Nachricht. Mehrere Seiten trennst du mit Kommas. Die CLI macht dasselbe mit demi events subscribe.
Rechte und Fehler
Die API erweitert nie deine Rechte. Siehst du eine Seite in der App nicht, liefert sie dir auch die API nicht, und was du nicht ändern darfst, lehnt sie ab. demi prüft das bei jeder Anfrage auf dem Server.
401: Token fehlt, ist abgelaufen oder widerrufen.422: Die Anfrage passt nicht, zum Beispiel ein fehlender oder widersprüchlicher Mandant.
