Automatizzate le sessioni di retrospettiva, i controlli di integrità e le azioni con l’API di TeamRetro
L’API REST e i webhook di TeamRetro consentono di automatizzare retrospettive, controlli di integrità, azioni e team, nonché di inviare gli eventi direttamente ai propri sistemi. Progettati anche per gli agenti basati sull’intelligenza artificiale.
Un’unica API REST per retrospettive, controlli di integrità, azioni e team
Inserite i riepiloghi retrospettivi nei vostri report, sincronizzate le azioni con il vostro sistema di monitoraggio, configurate i team dal vostro sistema HR: qualunque siano le esigenze del vostro flusso di lavoro. Effettuate l’autenticazione con un token bearer e siete pronti a partire:
curl https://developer.teamretro.com/api/v1/actions \
-H "Authorization: Bearer $TEAMRETRO_API_KEY"Cosa potete realizzare
Team e persone
Elencare e gestire i team, i membri e i ruoli. Effettuare il provisioning degli utenti dai propri sistemi.
Azioni e accordi
Creare, aggiornare e chiudere le azioni; leggere e mantenere gli accordi operativi.
Riunioni e salute
Legga i metadati relativi alle analisi retrospettive, alle verifiche dello stato di salute e alle stime, oltre ai modelli di salute, per alimentare i Suoi report.
Esportazioni dei report
Scaricate i file CSV relativi alle attività del team, alle azioni, alle sessioni di retrospettiva e di valutazione dello stato di salute, allo stato di salute del team e agli utenti.
Autenticazione e accesso
Chiavi al portatore, con ambito
Creare le chiavi nella sezione Impostazioni → API e SCIM con ambito Lettura, Scrittura o SCIM. Inviarle come Authorization: Bearer <key>. Revocare qualsiasi chiave non appena necessario.
A livello di team in ogni piano
Le chiavi a livello di team sono disponibili su tutti i piani. Il piano Enterprise sblocca le chiavi a livello di account e tra team, oltre al provisioning SCIM, in linea con la nostra politica relativa alle analisi tra team tramite MCP. I titolari dell’organizzazione possono disabilitare l’accesso alle API e a MCP per l’intero account in qualsiasi momento.
Webhook: venite a sapere immediatamente quando si verifica un evento
Non effettuate il polling. Indirizzate TeamRetro verso un endpoint e invieremo un evento firmato non appena si verificherà un cambiamento: il completamento di un retro o di un controllo di integrità, la creazione, la riassegnazione o la chiusura di un’azione, la modifica di un accordo, l’adesione di un membro o quando qualcuno viene @menzionato.
{
"event": "action.completed",
"timestamp": "2026-06-09T10:30:00.000Z",
"data": { "action": { "id": "…", "title": "Fix flaky CI", "team": "Mobile" } }
}Per ogni squadra, in modalità self-service
Configurare la funzione in Team → Impostazioni → Integrazioni. Selezionare gli eventi, impostare il proprio endpoint, ottenere un segreto di firma generato automaticamente e inviare un evento di prova.
Firmato e verificabile
Ogni consegna è accompagnata da un (X-TeamRetro-SignatureHMAC-SHA256) e da un ID di consegna univoco, in modo da poter verificarne l’autenticità ed eliminare i duplicati.
Consegna affidabile
Solo HTTPS, timeout di 30 secondi e tentativi automatici (immediati, poi dopo 1 minuto, 5 minuti, 30 minuti e 2 ore) prima che un endpoint non funzionante venga messo in pausa.
Progettato anche per gli agenti di intelligenza artificiale
Guida rapida
Elenchi le azioni aperte di una squadra, quindi ne chiuda una:
# 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 documentazione completa, che copre tutte le risorse, i filtri e i campi, è disponibile all’indirizzo developer.teamretro.com/docs.
Domande frequenti
Chi può utilizzare l'API?
Come posso effettuare l'autenticazione?
Authorization: Bearer <key>. Al momento della creazione, alle chiavi vengono assegnati i livelli di autorizzazione Lettura, Scrittura o SCIM, che possono essere revocati in qualsiasi momento.Webhook o polling?
Esiste un'opzione AI / MCP?
Dove si trova la documentazione completa delle API?
Sicurezza, conformità e controllo di livello aziendale
TeamRetro ha ottenuto la certificazione SOC 2 Tipo 2 da parte di un revisore indipendente che ha valutato le nostre politiche, il nostro prodotto, la nostra piattaforma e la nostra infrastruttura in conformità con lo Standard on Assurance Engagements (ASAE 3150).
Conformità al GDPR e hosting regionale (Stati Uniti e UE)
Accesso unico (SSO) tramite SAML
SCIM per la gestione scalabile degli utenti
Registri di audit disponibili su richiesta
Garantiamo un tempo di operatività del 99,99%, con SLA che prevedono tempi di risposta rapidi per assicurare che i Suoi team rimangano produttivi e ricevano il supporto necessario.Pannello di controllo dello stato