Automatisez les rétrospectives, les bilans de santé et les actions grâce à l'API TeamRetro
L'API REST et les webhooks de TeamRetro vous permettent d'automatiser les rétrospectives, les contrôles d'état, les actions et la gestion des équipes, et de transmettre directement les événements vers vos propres systèmes. Conçus également pour les agents IA.
Une seule API REST pour les rétrospectives, les contrôles d’intégrité, les actions et les équipes
Intégrez des résumés rétrospectifs dans vos rapports, synchronisez les actions avec votre outil de suivi, affectez les équipes depuis votre système RH… Quels que soient les besoins de votre flux de travail. Authentifiez-vous à l’aide d’un jeton « bearer » et c’est parti :
curl https://developer.teamretro.com/api/v1/actions \
-H "Authorization: Bearer $TEAMRETRO_API_KEY" Ce que vous pouvez construire
Équipes et collaborateurs
Répertoriez et gérez les équipes, les membres et les rôles. Créez des comptes utilisateurs à partir de vos propres systèmes.
Mesures et accords
Créer, mettre à jour et clôturer des dossiers ; lire et tenir à jour les accords de collaboration.
Réunions et santé
Consultez les métadonnées relatives aux analyses rétrospectives, aux bilans de santé et aux estimations, ainsi que les modèles de santé, afin d’alimenter vos rapports.
Exportations de rapports
Télécharger les fichiers CSV — activité des équipes, activité des actions, activité liée aux rétrospectives et aux bilans de santé, état de santé des équipes et utilisateurs.
Authentification et accès
Clés au porteur, avec champ d’application défini
Créez des clés dans Paramètres → API et SCIM avec les droits Lecture, Écriture ou SCIM. Envoyez-les au format Authorization: Bearer <key>. Révoquez toute clé dès que nécessaire.
Au niveau de l’équipe, quel que soit le forfait
Les clés au niveau de l’équipe fonctionnent sur tous les forfaits. Enterprise donne accès à des clés inter-équipes à l’échelle du compte, ainsi qu’à l’approvisionnement SCIM — la même ligne de conduite que celle que nous appliquons pour les informations inter-équipes via MCP. Les propriétaires d’organisation peuvent désactiver l’accès à l’API et à MCP pour l’ensemble du compte à tout moment.
Webhooks — soyez informé dès que cela se produit
N’effectuez pas d’interrogation. Configurez TeamRetro pour qu’il pointe vers un point de terminaison et nous vous enverrons un événement signé dès qu’un changement se produit : lorsqu’une rétrospective ou un contrôle d’état est terminé, lorsqu’une action est créée, réattribuée ou clôturée, lorsqu’un accord est modifié, lorsqu’un membre rejoint l’équipe ou lorsqu’une personne est @mentionnée.
{
"event": "action.completed",
"timestamp": "2026-06-09T10:30:00.000Z",
"data": { "action": { "id": "…", "title": "Fix flaky CI", "team": "Mobile" } }
}Par équipe, en libre-service
Effectuez la configuration sous Équipe → Paramètres → Intégrations. Sélectionnez les événements, définissez votre point de terminaison, récupérez une clé de signature générée automatiquement et envoyez un événement test.
Signé et vérifiable
Chaque livraison est accompagnée d’unX-TeamRetro-Signature (HMAC-SHA256) et d’un identifiant de livraison unique, ce qui vous permet d’en vérifier l’authenticité et d’éliminer les doublons.
Une livraison fiable
HTTPS uniquement, délai d’expiration de 30 secondes et tentatives de reconnexion automatiques (immédiatement, puis au bout de 1 min, 5 min, 30 min et 2 h) avant que le point de terminaison défaillant ne soit mis en attente.
Conçu également pour les agents IA
Guide de démarrage rapide
Répertoriez les actions en cours d’une équipe, puis clôturez-en une :
# Find open actions for a team
curl "https://developer.teamretro.com/api/v1/actions?status=open" \
-H "Authorization: Bearer $TEAMRETRO_API_KEY"
# Mark an action complete
curl -X PATCH https://developer.teamretro.com/api/v1/actions/$ACTION_ID \
-H "Authorization: Bearer $TEAMRETRO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "status": "completed" }'La documentation complète — comprenant toutes les ressources, tous les filtres et tous les champs — est disponible à l’adresse developer.teamretro.com/docs.
Questions et réponses
Qui peut utiliser l'API ?
Comment puis-je m'authentifier ?
Authorization: Bearer <key>en-tête. Lors de leur création, les clés sont associées aux périmètres Lecture, Écriture ou SCIM, et peuvent être révoquées à tout moment.Webhooks ou interrogation régulière ?
Existe-t-il une option IA / MCP ?
Où puis-je trouver la documentation complète de l'API ?
Sécurité, conformité et contrôle de niveau entreprise
TeamRetro est certifié SOC 2 Type 2 par un auditeur indépendant qui a évalué nos politiques, notre produit, notre plateforme et notre infrastructure conformément à la norme relative aux missions d'assurance (ASAE 3150).
-
Conformité au RGPD et hébergement régional (États-Unis et UE)
-
Authentification unique (SSO) via SAML
-
SCIM pour une gestion évolutive des comptes utilisateurs
-
Les journaux d'audit sont disponibles sur simple demande
Nous garantissons une disponibilité de 99,9 %, avec des accords de niveau de service (SLA) prévoyant des délais de réponse rapides afin d'assurer la productivité et le soutien de vos équipes. Tableau de bord des statuts