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?
Las claves API a nivel de equipo están disponibles en todos los planes. El plan Enterprise incluye claves válidas para toda la cuenta y para todos los equipos, así como el aprovisionamiento SCIM. Puede crear y revocar claves en Configuración → API y SCIM.
¿Cómo puedo autenticarme?
Cada solicitud incluye unAuthorization: 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?
Prefiera los webhooks: TeamRetro envía una notificación en el momento en que ocurre algo (se completa una sesión de retro, se crea o se cierra una acción), por lo que no es necesario que realice consultas periódicas. Cada notificación está firmada, por lo que puede verificar que procede de nosotros.
¿Existe alguna opción de IA o MCP?
Sí. Si prefiere trabajar con lenguaje natural en lugar de escribir código, el servidor MCP de TeamRetro conecta a Claude, ChatGPT y otros asistentes a los mismos datos.
¿Dónde se encuentra la documentación completa de la API?
La guía de referencia completa se encuentra en developer.teamretro.com/docs.

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).

SOC 2 Type 2 SOC 3
  • 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