Référence API

Deux familles : l'API publique (chat, sessions, OTP) appelée depuis votre site ou votre serveur, et l'API d'administration (JWT) pour piloter votre espace. Toutes les routes sont préfixées par /api/v1.

• Chat : POST /re-act-agent/chat et POST /re-act-agent/chat/stream (SSE). Header Idempotency-Key pour réessayer sans doublon.
• Sessions : POST /re-act-agent/session/init, GET /re-act-agent/session/history, POST /re-act-agent/session/otp/request puis /otp/verify.
• Administration : POST /admin/auth/login renvoie un accessToken, à passer en Authorization: Bearer <token>.
• Ressources : /admin/bots, /admin/functions (+ /:id/test), /admin/mcp/servers, /admin/connectors, /admin/webhooks (+ /:id/test), /admin/evals, /admin/guardrails/:botId, /admin/conversations, /admin/stats.
• Codes : 400 requête invalide, 401 jeton absent ou signature invalide, 403 rôle insuffisant, 404 ressource inconnue, 409 conflit (message en cours, flow modifié ailleurs), 429 limite atteinte.

# 1. Connexion : renvoie un accessToken
curl -X POST https://api.votredomaine.com/api/v1/admin/auth/login \
  -H "Content-Type: application/json" \
  -d '{ "email": "vous@entreprise.com", "password": "••••••••" }'

# 2. Appels d'administration
curl https://api.votredomaine.com/api/v1/admin/bots -H "Authorization: Bearer <accessToken>"