Zum Inhalt springen

REST-API

Die REST-API von demi: Basis-URL, Anmeldung per API-Schlüssel oder OAuth, Mandanten, wichtige Endpunkte und Echtzeit-Ereignisse, mit den Rechten der App.

LiveStand: 9. November 2026

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

Terminal
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:

Terminal
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

GET/v1/me/profile
Dein Profil. Der einfachste Test für Schlüssel und Verbindung.
GET/v1/docs
Seiten auflisten. Suche mit q, seitenweise mit cursor und limit (bis 200).
GET/v1/docs/grep
Volltextsuche über alle Seiten, die du sehen darfst.
GET/v1/docs/{id}
Eine Seite mit Blöcken und Links. format=ddmd liefert sie als Markdown.
POST/v1/docs
Eine Seite anlegen, auf Wunsch gleich mit ersten Blöcken.
PATCH/v1/docs/{id}
Titel, Beschreibung oder Status einer Seite ändern.
GET/v1/agents
Die Agenten deines Mandanten.
POST/v1/runs
Einen Lauf starten; GET /v1/runs/{id} zeigt seinen Stand.
SSE/v1/stream/events
Ereignisse zu bis zu 50 Seiten in Echtzeit.

Seiten lesen und suchen

Terminal
curl "https://api.godemi.com/v1/docs?q=Angebot&limit=20" \  -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

Terminal
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.

Gut zu wissen

Dein Konfigurator

Noch keine Anwendungsfälle

Dein Konfigurator ist noch leer

Füge einen Anwendungsfall hinzu, auf jeder Karte und jeder Fallseite, und sieh, was er pro Jahr bringt, mit der Rechnung dazu. Kostenlos, ohne Anmeldung, unverbindlich: probier es aus und ändere jede Zahl.

Anwendungsfälle ansehen