Référence API

Construisez des intégrations personnalisées, automatisez les flux de travail et gérez les assistants de manière programmatique.

Note : L’API applicative de CollowAI fonctionne sur Railway. Des endpoints REST sont disponibles pour le chat du widget, les webhooks et l’accès programmatique. Consultez les sections suivantes pour plus de détails.

Endpoints HTTP

Ces endpoints HTTP sont disponibles pour l'intégration du widget et la gestion des webhooks :

POST/api/chat

Envoyez un message à un assistant et recevez une réponse générée par l'IA. Utilisé par le widget intégrable. Accepte l'ID de l'assistant, le message de l'utilisateur et le contexte de conversation optionnel.

POST/api/webhooks/polar

Récepteur webhook pour les événements de paiement Polar.sh (abonnements, factures, etc.). Configurez-le dans les paramètres de votre organisation Polar.sh.

API Backend

L’API applicative de CollowAI fonctionne sur Railway. Tous les endpoints sont accessibles via l’API REST. Les groupes de ressources courants incluent :

Assistants

Créez, mettez à jour, supprimez et interrogez les assistants. Gérez leurs configurations, modèles et statut.

Conversations

Listez les conversations, envoyez des messages et récupérez l'historique des messages pour chaque assistant.

Sources de Connaissances

Téléchargez des documents, gérez les connexions de base de données et configurez les bases de connaissances pour chaque assistant.

Intégrations

Connectez et gérez les intégrations tierces, consultez l'état de synchronisation et déclenchez des synchronisations manuelles.

Configuration du Widget

Configurez et récupérez les paramètres du widget incluant la marque, le positionnement et le CSS personnalisé pour le chat intégré.

Deuxième Cerveau

Interrogez les connaissances structurées : entités, faits, thèmes, relations et conflits extraits de vos documents.

Facturation et Abonnements

Interrogez le statut de l'abonnement, listez les factures et gérez les informations de facturation.

Utilisation du SDK Client

Pour les intégrations personnalisées, utilisez directement l'API REST :

# 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

Authentification

Les requêtes API sont authentifiées à l'aide de clés API générées depuis votre tableau de bord (Paramètres, Clés API). Incluez votre clé dans l'en-tête Authorization :

Authorization: Bearer YOUR_API_KEY