📡 REST-API-Referenz

Alle API-Endpoints haben das Präfix /api/ und erfordern Authentifizierung über Session-Cookie. Alle Anfragen und Antworten verwenden Content-Type: application/json.

---

Konversationen

Endpoint	Methode	Beschreibung
/api/conversations	GET	Konversationen auflisten (Filter: status, channel_type, tag, search, page)
/api/conversations/{id}	GET	Konversation abrufen (setzt unread_count zurück)
/api/conversations	POST	Konversation erstellen
/api/conversations/{id}/status	POST	Status aktualisieren
/api/conversations/{id}/tags	POST	Tag hinzufügen
/api/conversations/{id}/tags/{tag}	DELETE	Tag entfernen
/api/conversations/{id}/assign	POST	Agent zuweisen

Nachrichten

Endpoint	Methode	Beschreibung
/api/conversations/{id}/messages	GET	Nachrichten auflisten
/api/conversations/{id}/messages	POST	Nachricht senden

KI-Vorschlag

Endpoint	Methode	Beschreibung
/api/ai-suggest?conversation_id={id}	GET	KI-Antwortvorschlag erhalten

Kontakte

Endpoint	Methode	Beschreibung
/api/contacts	GET	Kontakte auflisten
/api/contacts/{id}	GET	Kontakt abrufen
/api/contacts	POST	Kontakt erstellen
/api/contacts/{id}	PATCH	Kontakt aktualisieren
/api/contacts/{id}	DELETE	Kontakt löschen (Admin)

Kanäle (nur Admin)

Endpoint	Methode	Beschreibung
/api/channels	GET	Kanäle auflisten
/api/channels	POST	Kanal erstellen
/api/channels/{id}	PATCH	Kanal aktualisieren
/api/channels/{id}	DELETE	Kanal löschen

Automatisierungen (nur Admin)

Endpoint	Methode	Beschreibung
/api/automations	GET	Automatisierungen auflisten
/api/automations	POST	Automatisierung erstellen
/api/automations/{id}/toggle	POST	Aktiv/inaktiv umschalten
/api/automations/{id}	DELETE	Automatisierung löschen

Analysen

Endpoint	Methode	Beschreibung
/api/analytics?days=30	GET	Analysedaten abrufen

Agenten (nur Admin)

Endpoint	Methode	Beschreibung
/api/agents	GET	Agenten auflisten
/api/agents	POST	Agent erstellen
/api/agents/{id}/role	POST	Rolle aktualisieren
/api/agents/{id}	DELETE	Agent löschen

Einstellungen

Endpoint	Methode	Beschreibung
/api/settings/workspace	GET	Workspace-Einstellungen abrufen
/api/settings/workspace	POST	Workspace aktualisieren (Admin)
/api/settings/password	POST	Passwort ändern

---

Fehlerformat

{"error": "Lesbare Fehlermeldung"}

Code	Bedeutung
200	Erfolg
201	Erstellt
400	Fehlerhafte Anfrage
401	Nicht authentifiziert
403	Verboten
404	Nicht gefunden
409	Konflikt
500	Interner Fehler