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 sistema de seguimiento, asigne equipos desde su sistema de RR. HH. o cualquier otra necesidad que tenga su flujo de trabajo. 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 trabajo.
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
Descargue archivos CSV con datos sobre la actividad del equipo, las acciones realizadas, las sesiones de retrospectiva y de evaluación del estado, el estado del equipo y los usuarios.
Autenticación y acceso
Claves de portador, con ámbito de aplicación
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, siguiendo la misma línea que aplicamos 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 se conecte a un punto final y le enviaremos una notificación firmada tan pronto como se produzca algún cambio: cuando finalice una revisión 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 un (X-TeamRetro-SignatureHMAC-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 minuto, 5 minutos, 30 minutos y 2 horas) antes de que se suspenda un punto final que no funcione correctamente.
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, que abarca todos los recursos, filtros y campos, se encuentra en developer.teamretro.com/docs.
Preguntas frecuentes
¿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 sondeo?
¿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,99 %, 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