Automatiseer retrospectieven, statuscontroles en acties met de TeamRetro API

Met de TeamRetro REST API en webhooks kunt u retrospectieven, statuscontroles, 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 inzien en bijhouden.

Vergaderingen en gezondheid

Lees metadata over retrospectieven, gezondheidscontroles, schattingen en Standups, evenals gezondheidsmodellen, om uw rapportage te onderbouwen.

Rapportuitvoer

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

Authenticatie en toegang

Drager-sleutels, met bereik

Maak sleutels aan onder Instellingen → API & SCIM met de reikwijdte 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. Business en Enterprise bieden toegang tot accountbrede, teamoverschrijdende sleutels en SCIM-provisioning; dit is dezelfde grens die wij hanteren voor teamoverschrijdende inzichten via MCP. Organisatie-eigenaren kunnen de toegang tot de API en MCP op elk moment voor het gehele account 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: een retro of statuscontrole is voltooid, een actie is aangemaakt, opnieuw toegewezen of afgesloten, een overeenkomst is gewijzigd, een lid is toegetreden of iemand is @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 vermeldingen kunt verwijderen.

Betrouwbare levering

Alleen HTTPS, een time-out van 30 seconden en automatische herhalingspogingen (onmiddellijk, vervolgens na 1 minuut, 5 minuten, 30 minuten en 2 uur) voordat een defecte 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. De abonnementen Business en Enterprise bieden 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>. Sleutels krijgen bij het aanmaken de status Lezen, Schrijven of SCIM en kunnen op elk moment 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 beschikt over een SOC 2 Type 2-rapport. Een onafhankelijke auditor heeft de controlemaatregelen met betrekking tot ons beleid, ons product, ons platform en onze infrastructuur onderzocht volgens de attestatienormen van de AICPA. Ontdek TeamRetro voor bedrijven.

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.Ontdek de zakelijke mogelijkheden