Automatice las reuniones retrospectivas, las comprobaciones de estado y las acciones con la API de TeamRetro
La API REST y los webhooks de TeamRetro le permiten automatizar retrospectivas, comprobaciones de estado, acciones y equipos, así como enviar eventos directamente a sus propios sistemas. También está diseñada para agentes de IA.
Una única API REST para retrospectivas, comprobaciones de estado, acciones y equipos
Incorpore resúmenes de Retro a sus informes, sincronice acciones con su herramienta de seguimiento, asigne equipos desde su sistema de RR. HH.… lo que su flujo de trabajo necesite. Autentíquese con un token de portador y ya estará listo:
curl https://developer.teamretro.com/api/v1/actions \
-H "Authorization: Bearer $TEAMRETRO_API_KEY" Lo que puede construir
Equipos y personas
Cree y gestione equipos, miembros y funciones. Asigne usuarios desde sus propios sistemas.
Medidas y acuerdos
Crear, actualizar y dar por concluidas las actuaciones; leer y mantener los acuerdos de colaboración.
Reuniones y salud
Consulte los metadatos retrospectivos, de comprobación del estado y de estimación, así como los modelos de estado, para alimentar sus informes.
Exportaciones de informes
Descargar archivos CSV: actividad del equipo, actividad de acciones, actividad de retrospectivas y evaluaciones de estado, estado del equipo y usuarios.
Autenticación y acceso
Claves de portador, con ámbito
Cree claves en Configuración → API y SCIM con el ámbito Lectura, Escritura o SCIM. Envíelas como Authorization: Bearer <key>. Revoque cualquier clave en cuanto sea necesario.
A nivel de equipo en todos los planes
Las claves con ámbito de equipo funcionan en todos los planes. Enterprise permite el uso de claves para toda la cuenta y entre equipos, además del aprovisionamiento SCIM —la misma línea que trazamos para la información entre equipos a través de MCP—. Los propietarios de la organización pueden desactivar el acceso a la API y a MCP para toda la cuenta en cualquier momento.
Webhooks: entérese en el momento en que ocurra
No realice consultas periódicas. Configure TeamRetro para que apunte a un punto final y le enviaremos un evento firmado tan pronto como se produzca algún cambio: cuando finalice una sesión de «retro» o una comprobación de estado, cuando se cree, reasigne o cierre una acción, cuando se modifique un acuerdo, cuando se incorpore un miembro o cuando se mencione a alguien con @.
{
"event": "action.completed",
"timestamp": "2026-06-09T10:30:00.000Z",
"data": { "action": { "id": "…", "title": "Fix flaky CI", "team": "Mobile" } }
}Por equipo, autoservicio
Configure esta opción en Equipo → Ajustes → Integraciones. Seleccione los eventos, configure su punto final, obtenga un secreto de firma generado automáticamente y envíe un evento de prueba.
Firmado y verificable
Cada entrega incluye unX-TeamRetro-Signature (HMAC-SHA256) y un identificador de entrega único, lo que le permite verificar su autenticidad y eliminar duplicados.
Entrega fiable
Solo HTTPS, tiempo de espera de 30 segundos y reintentos automáticos (inmediato, luego 1 m, 5 m, 30 m y 2 h) antes de que se suspenda un punto final que no responde.
Diseñado también para agentes de IA
Guía de inicio rápido
Enumere las acciones pendientes de un equipo y, a continuación, cierre una de ellas:
# 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 referencia completa —todos los recursos, filtros y campos— se encuentra en developer.teamretro.com/docs.
Preguntas y respuestas
¿Quién puede utilizar la API?
¿Cómo puedo autenticarme?
Authorization: Bearer <key>encabezado. Las claves tienen un ámbito de Lectura, Escritura o SCIM en el momento de su creación, y pueden revocarse en cualquier momento.¿Webhooks o sondeos?
¿Existe alguna opción de IA o MCP?
¿Dónde se encuentra la documentación completa de la API?
Seguridad, cumplimiento normativo y control de nivel empresarial
TeamRetro cuenta con la acreditación SOC 2 Tipo 2, otorgada por un auditor independiente que ha evaluado nuestras políticas, nuestro producto, nuestra plataforma y nuestra infraestructura de conformidad con la Norma sobre encargos de aseguramiento (ASAE 3150).
-
Cumplimiento del RGPD y alojamiento regional (EE. UU. y UE)
-
Inicio de sesión único (SSO) a través de SAML
-
SCIM para la gestión escalable de usuarios
-
Registros de auditoría disponibles previa solicitud
Mantenemos un tiempo de actividad del 99,9 %, con acuerdos de nivel de servicio (SLA) de respuesta rápida para garantizar que sus equipos sigan siendo productivos y cuenten con el apoyo necesario. Cuadro de mando de estado