KayrosLab — API publique v1

Déclenchez une mission de collectif d'agents depuis votre CRM et récupérez le verdict (GO, CONDITIONAL_GO, NO_GO), les risques, les conditions et le lien vers le dossier.

  1. Console → Intégrations → créez une clé d'API (affichée une seule fois).
  2. Testez-la : GET /v1/public/me, puis choisissez un collectif avec GET /v1/public/collectives.
  3. Lancez une mission ; profil demo pour une réponse simulée en moins de 5 s, fast (défaut) pour un verdict réel en 1 à 2 min.
curl -s https://api.kayroslab.com/v1/public/missions \
  -H "Authorization: Bearer $KAYROS_API_KEY" \
  -H "Idempotency-Key: sf-0065g00000XyZab-Proposal" \
  -H "Content-Type: application/json" \
  -d '{"collective_id":"room_…","question":"Faut-il signer ACME à -15 % ?","profile":"demo",
       "external_ref":"salesforce:Opportunity:0065g00000XyZab"}'

curl -s https://api.kayroslab.com/v1/public/missions/msn_… -H "Authorization: Bearer $KAYROS_API_KEY"

Webhooks : en-tête X-Kayros-Signature: t=<unix>,v1=<hex> avec v1 = HMAC-SHA256(secret, t + "." + corps brut). Rejetez au-delà de 5 minutes d'écart et dédupliquez sur event_id.