Automatiseer retro’s, statuscontroles en acties met de TeamRetro API

Met de TeamRetro REST API en webhooks kunt u retrospectieven, gezondheidscontroles, acties en teams automatiseren en gebeurtenissen rechtstreeks naar uw eigen systemen doorsturen. Ook geschikt voor AI-agenten.

Lees de API-documentatieProbeer TeamRetro gratis uit

Eén REST-API voor retrospectieven, statuscontroles, acties en teams

Neem Retro-overzichten op in uw rapporten, synchroniseer acties met uw tracker, stel teams samen vanuit uw HR-systeem – wat uw workflow ook vereist. Meld u aan met een bearer-token en u kunt aan de slag:

curl https://developer.teamretro.com/api/v1/actions \
  -H "Authorization: Bearer $TEAMRETRO_API_KEY"
Lees de API-documentatieGeeft u de voorkeur aan chatten? Maak dan gebruik van de MCP-server

Wat u kunt bouwen

Teams en medewerkers

Teams, leden en rollen weergeven en beheren. Gebruikers vanuit uw eigen systemen toevoegen.

Maatregelen en overeenkomsten

Acties aanmaken, bijwerken en afsluiten; werkafspraken doornemen en bijhouden.

Vergaderingen en gezondheid

Lees metadata over retrospectieve gegevens, gezondheidscontroles en schattingen, evenals gezondheidsmodellen, om uw rapportage te onderbouwen.

Rapportuitvoer

Download CSV-bestanden met gegevens over teamactiviteiten, acties, retro- en health-check-activiteiten, de teamstatus en gebruikers.

Authenticatie en toegang

Dragersleutels, met bereikbeperking

Maak sleutels aan onder Instellingen → API & SCIM met de bereikniveaus Lezen, Schrijven of SCIM. Verstuur deze als Authorization: Bearer <key>. Trek elke sleutel in zodra dat nodig is.

Op teamniveau bij elk abonnement

Sleutels op teamniveau werken bij alle abonnementen. Enterprise biedt toegang tot accountbrede, teamoverschrijdende sleutels plus SCIM-provisioning, dezelfde grens die wij hanteren voor teamoverschrijdende inzichten via MCP. Organisatie-eigenaren kunnen de API- en MCP-toegang voor het gehele account te allen tijde uitschakelen.

Webhooks: weet het direct wanneer het gebeurt

Voer geen polling uit. Richt TeamRetro op een eindpunt en wij sturen u een ondertekende melding zodra er iets verandert: wanneer een retro of statuscontrole is voltooid, een actie is aangemaakt, opnieuw is toegewezen of is afgesloten, een overeenkomst is gewijzigd, een lid zich aansluit of iemand wordt @vermeld.

{
  "event": "action.completed",
  "timestamp": "2026-06-09T10:30:00.000Z",
  "data": { "action": { "id": "…", "title": "Fix flaky CI", "team": "Mobile" } }
}

Per team, zelfbediening

Configureer dit onder Team → Instellingen → Integraties. Kies de gebeurtenissen, stel uw eindpunt in, verkrijg een automatisch gegenereerde ondertekeningscode en verstuur een testgebeurtenis.

Ondertekend en verifieerbaar

Elke levering is voorzien van een (X-TeamRetro-SignatureHMAC-SHA256) en een uniek leverings-ID, zodat u de authenticiteit kunt controleren en dubbele gegevens kunt verwijderen.

Betrouwbare levering

Alleen HTTPS, een time-out van 30 seconden en automatische herpogingen (onmiddellijk, vervolgens na 1 minuut, 5 minuten, 30 minuten en 2 uur) voordat een niet-reagerend eindpunt wordt gepauzeerd.

Lees de handleiding over webhooks

Ook ontworpen voor AI-agenten

Snelstart

Geef een overzicht van de openstaande acties van een team en sluit er vervolgens één af:

# 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" }'

De volledige handleiding, waarin alle bronnen, filters en velden worden behandeld, vindt u op developer.teamretro.com/docs.

Veelgestelde vragen

Wie kan de API gebruiken?
API-sleutels op teamniveau zijn beschikbaar in alle abonnementen. Het Enterprise-abonnement biedt bovendien accountbrede, teamoverschrijdende sleutels en SCIM-provisioning. U kunt sleutels aanmaken en intrekken via Instellingen → API & SCIM.
Hoe kan ik mij aanmelden?
Elk verzoek bevat een headerAuthorization: Bearer <key>. Bij het aanmaken krijgen sleutels de status Lezen, Schrijven of SCIM, en deze kunnen te allen tijde worden ingetrokken.
Webhooks of polling?
Geef de voorkeur aan webhooks. TeamRetro verstuurt een melding zodra er iets gebeurt (een retro is voltooid, een actie is aangemaakt of afgesloten), zodat u niet zelf hoeft te controleren. Elke melding is ondertekend, zodat u kunt verifiëren dat deze afkomstig is van ons.
Is er een AI/MCP-optie?
Ja. Als u liever in natuurlijke taal werkt dan dat u code schrijft, koppelt de TeamRetro MCP-server Claude, ChatGPT en andere assistenten aan dezelfde gegevens.
Waar vindt men de volledige API-documentatie?
De volledige referentie is te vinden op developer.teamretro.com/docs.

Beveiliging, naleving en controle op bedrijfsniveau

TeamRetro is SOC 2 Type 2-gecertificeerd door een onafhankelijke auditor die ons beleid, ons product, ons platform en onze infrastructuur heeft beoordeeld in overeenstemming met de Standard on Assurance Engagements (ASAE 3150).

SOC 2 AANVRAGEN VIA HET TRUST CENTERSOC 3 DOWNLOADEN
SOC 2 Type 2SOC 3

  • Naleving van de AVG en regionale hosting (VS en EU)

  • Single Sign-On (SSO) via SAML

  • SCIM voor schaalbare gebruikersaanmaak

  • Auditlogboeken zijn op verzoek beschikbaar

Wij garanderen een beschikbaarheid van 99,99%, met SLA’s die snelle reactietijden waarborgen, zodat uw teams productief kunnen blijven en de nodige ondersteuning krijgen.Statusdashboard