API-Referenz

Erstellen Sie benutzerdefinierte Integrationen, automatisieren Sie Workflows und verwalten Sie Assistenten programmgesteuert.

Hinweis: Die Anwendungs-API von CollowAI läuft auf Railway. REST-Endpunkte sind für Widget-Chat, Webhooks und programmgesteuerten Zugriff verfügbar. Details finden Sie in den folgenden Abschnitten.

HTTP-Endpunkte

Diese HTTP-Endpunkte sind für Widget-Einbindung und Webhook-Verarbeitung verfügbar:

POST/api/chat

Senden Sie eine Nachricht an einen Assistenten und erhalten Sie eine KI-generierte Antwort. Wird vom einbetbbaren Widget verwendet. Akzeptiert Assistenten-ID, Benutzernachricht und optionalen Unterhaltungskontext.

POST/api/webhooks/polar

Webhook-Empfänger für Polar.sh-Zahlungsereignisse (Abonnements, Rechnungen usw.). Konfigurieren Sie dies in Ihren Polar.sh-Organizationseinstellungen.

Backend-API

Die Anwendungs-API von CollowAI läuft auf Railway. Alle Endpunkte sind über die REST-API zugänglich. Gängige Ressourcengruppen umfassen:

Assistenten

Erstellen, aktualisieren, löschen und abfragen von Assistenten. Verwalten Sie deren Konfigurationen, Modelle und Status.

Unterhaltungen

Unterhaltungen auflisten, Nachrichten senden und Nachrichtenverlauf für jeden Assistenten abrufen.

Wissensquellen

Dokumente hochladen, Datenbankverbindungen verwalten und Wissensdatenbanken für jeden Assistenten konfigurieren.

Integrationen

Drittanbieter-Integrationen verbinden und verwalten, Sync-Status anzeigen und manuelle Synchronisierungen auslösen.

Widget-Konfiguration

Widget-Einstellungen konfigurieren und abrufen, einschließlich Branding, Positionierung und benutzerdefiniertem CSS für eingebetteten Chat.

Zweites Gehir

Strukturiertes Wissen abfragen: Entitäten, Fakten, Themen, Beziehungen und Konflikte, die aus Ihren Dokumenten extrahiert wurden.

Abrechnung & Abonnements

Abonnementstatus abfragen, Rechnungen auflisten und Abrechnungsinformationen verwalten.

Client-SDK-Verwendung

Für benutzerdefinierte Integrationen verwenden Sie direkt die REST-API:

# List assistants
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants

# Create an assistant
curl -X POST \
  -H "Authorization: Bearer assai_*" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Assistant"}' \
  https://api.collowai.com/api/v1/assistants

# Get Second Brain stats
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/stats

# List brain entities
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/entities

# List brain facts
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/facts

# List brain topics
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/topics

# List brain relationships
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/relationships

# List brain conflicts
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/conflicts

# Get brain extractions history
curl -H "Authorization: Bearer assai_*" \
  https://api.collowai.com/api/v1/assistants/{assistantId}/brain/extractions

Authentifizierung

API-Anfragen werden mit API-Schlüsseln authentifiziert, die Sie in Ihrem Dashboard erstellen (Einstellungen → API-Schlüssel). Fügen Sie Ihren Schlüssel im Authorization-Header hinzu:

Authorization: Bearer YOUR_API_KEY