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

Voeg retro-overzichten toe aan 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"

Wat u kunt bouwen

Teams en medewerkers

Maak een overzicht van teams, leden en rollen en beheer deze. Voeg gebruikers toe vanuit uw eigen systemen.

Maatregelen en overeenkomsten

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

Vergaderingen en gezondheid

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

Rapportuitvoer

CSV-exportbestanden downloaden — teamactiviteit, actieactiviteit, retro- en health-check-activiteit, teamstatus en gebruikers.

Authenticatie en toegang

Drager-sleutels, met bereik

Maak sleutels aan onder Instellingen → API & SCIM met de reikwijdte Lezen, Schrijven of SCIM. Verstuur ze als Authorization: Bearer <key>. Trek een 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 en 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 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, ontvang een automatisch gegenereerde ondertekeningscode en verstuur een testgebeurtenis.

Ondertekend en verifieerbaar

Elke levering is voorzien van eenX-TeamRetro-Signature(HMAC-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.

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 documentatie — alle bronnen, filters en velden — vindt u op developer.teamretro.com/docs.

Vragen en antwoorden

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 eenAuthorization: Bearer <key>header. 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 stuurt 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 code te schrijven, koppelt de TeamRetro MCP-server Claude, ChatGPT en andere assistenten aan dezelfde gegevens.
Waar is de volledige API-documentatie te vinden?
De volledige handleiding vindt u 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 Type 2 SOC 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,9%, met SLA’s die snelle reactietijden waarborgen, zodat uw teams productief kunnen blijven en de nodige ondersteuning krijgen. Statusdashboard