Guide de navigation pour choisir les bons endpoints selon vos besoins.
Utilisez cette API si vous voulez :
Authentification : Clé API privée (Bearer token)
Endpoints principaux :
GET /v1/agents - Liste tous vos agentsPOST /v1/agents - Créer un agentGET /v1/agent/:id - Récupérer un agent (détaillé)PUT /v1/agents/:id - Mettre à jour un agentDELETE /v1/agents/:id - Supprimer un agentUtilisez cette API si vous voulez :
Authentification : Clé API publique (Bearer token) + tokens de session
Endpoints principaux :
GET /v1/chat/conversation/public/message/token - Générer un token de sessionGET /v1/chat/conversation/public/messages/:token - Récupérer les messagesPOST /v1/chat/conversation/public/message - Envoyer un message⚠️ Important : Cette API est conçue pour être appelée depuis votre backend pour générer des tokens, puis utilisée depuis votre frontend avec ces tokens.
Pour :
Authentification : Clé API privée
Pour :
Authentification : Clé API publique
Endpoint principal pour converser avec les agents (streaming, RAG, tools).
Upload multi-fichiers (jusqu'à 5000) avec extraction de contenu.
Gestion des dossiers et bases de connaissances pour vos agents.
Extraction et traitement de documents avec Odin.
Feedback utilisateur et actions sur les conversations.
Monitoring des tâches asynchrones (extraction, embeddings, etc.).
| Besoin | Documentation | Authentification |
|---|---|---|
| Gérer mes agents | agents.md | Clé API privée |
| Intégrer un agent dans mon app | agents-public.md | Clé API publique |
| Converser avec un agent | completions.md | Clé API privée |
| Gérer mes conversations | conversations.md | Clé API privée |
| Widget chat public | public-conversations.md | Clé API publique |
| Upload de fichiers | files.md | Clé API privée |
| Gérer les dossiers | folders.md | Clé API privée |
| Traiter des documents | documents.md | Clé API privée |
| Feedback utilisateur | interactions.md | Clé API privée |
| Monitoring des jobs | jobs.md | Clé API privée |