🤖 Verwalo für KI-Agenten

Mit einem API-Key kann ein Agent wie GitHub Copilot in deiner WEG mitarbeiten: Dokumente hochladen, Rechnungen als PDF erstellen, Fristen, Begehungen, Beschlüsse und Aufgaben pflegen.

1. API-Key erstellen

Ein Admin deiner WEG erzeugt den Key in der App über Administration → Agenten-API-Keys verwalten. Dort kann der Key direkt in einen Secret-Manager kopiert werden.

Für Automatisierungen ist die Erstellung auch per Login-Token möglich:

POST /api/verwaltung/WEG-Beispiel/api-keys
{ "name": "GitHub Copilot", "scope": "write" }   // scope: "read" oder "write"

→ 201 { "id": 1, "name": "GitHub Copilot", "key": "vwk_…" }

Der Key wird nur einmal angezeigt und serverseitig nur als Hash gespeichert. Mit GET /api/verwaltung/:weg/api-keys siehst du alle Keys samt letzter Nutzung, mit DELETE /api/verwaltung/:weg/api-keys/:id widerrufst du einen Key sofort.

2. Anfragen senden

Alle Agenten-Endpunkte liegen unter /api/agent/:weg/…. Der Key wird als Bearer-Token oder per X-API-Key-Header gesendet:

curl -H "Authorization: Bearer vwk_…" \
  "https://app.grindler-ivs.de/api/agent/WEG-Beispiel/fristen"

3. Was Agenten tun können

Aufgabe	Endpunkt
Dokument hochladen (multipart, Feld `file`, `area`, `category`, `title`)	`POST /documents`
Dokumente auflisten / herunterladen	`GET /documents?area=eigentuemer`, `GET /documents/:id/download`
Rechnung als PDF erstellen	`POST /invoices/pdf`
Fristen (z. B. Eigentümerversammlung) ansehen, anlegen, erledigen, wieder öffnen	`GET /fristen`, `POST /fristen`, `POST /fristen/:id/done`, `POST /fristen/:id/reopen`
Aufgaben anlegen und bearbeiten	`/todos`
Begehungen und Protokoll-PDF	`/begehungen`, `GET /begehungen/:id/pdf`
Beschluss-Sammlung	`/beschluesse`
Gesamtabrechnung lesen, PDF exportieren	`GET /abrechnungen/:year`, `GET /abrechnungen/:year/pdf`
Leitfaden-Checkliste	`/checklist`

Alle Pfade beginnen mit /api/agent/:weg. Beispiel Rechnung und Upload:

curl -X POST -H "X-API-Key: vwk_…" -H "Content-Type: application/json" \
  -d @rechnung.json -o rechnung.pdf \
  https://app.grindler-ivs.de/api/agent/WEG-Beispiel/invoices/pdf

curl -X POST -H "X-API-Key: vwk_…" \
  -F area=eigentuemer -F category=protokoll -F title="Protokoll 2026" -F file=@protokoll.pdf \
  https://app.grindler-ivs.de/api/agent/WEG-Beispiel/documents

Sicherheit

Ein Key gilt nur für eine WEG.
Read-Keys erlauben nur lesende Anfragen (GET).
Agenten haben keine Admin-Rechte: Einstellungen, Bearbeiten/Löschen von Fristen, Löschen von Abrechnungen und Key-Verwaltung bleiben Admins per Login vorbehalten.
Änderungen werden mit agent:<Key-Name> protokolliert. Widerrufene Keys sind sofort ungültig.
Gib Keys niemals in Repositories oder Chats weiter, sondern nur als Secret/Umgebungsvariable.

Kostenlos testen