Ir al contenido principal

Trabajar con la API de Leanmote

A los datos de Leanmote se llega de forma programática. Este artículo es el punto de entrada: qué superficies existen, cómo autenticarte contra ellas y para qué sirve cada una.


​

Las cuatro superficies de API


​

  • REST API — https://api.leanmote.com/v1. Organizaciones, equipos, usuarios, boards, tareas, interacciones, calendarios, vistas guardadas y reglas de alerta.

  • Metrics API — https://api.leanmote.com/v1/metrics/. Los payloads analíticos que hay detrás de los dashboards: DORA, flujo, colaboración y vistas financieras. Mismo dominio, servicio aparte.

  • SCIM — https://api.leanmote.com/scim/v2. Aprovisionamiento de usuarios y grupos para proveedores de identidad empresariales, con /Users, /Groups y ServiceProviderConfig. Las peticiones y respuestas usan application/scim+json.

  • Ingesta OTLP — telemetría de herramientas de IA para programar. El endpoint se genera por organización en vez de ser una URL fija, así que lo obtienes desde la página de la integración y no lo armas tú.


​

Autenticarte


​

Cada petición lleva un header Authorization. El prefijo Bearer es opcional: el token se acepta con o sin él.


​

Funcionan tres tipos de credencial:


​

  • Un token de API, que un Admin de la organización le emite a un usuario.

  • Una sesión de navegador, cuando la llamada viene de un contexto con sesión iniciada.

  • Una credencial de aplicación, emitida a una integración.


​

Hay una regla que sorprende a todo el mundo. Un token de API necesita además un header Organization con la organización que estás leyendo. Las sesiones y las credenciales de aplicación no: la organización ya forma parte de la credencial, así que el header se ignora.


​

Conseguir un token


​

Para esto no hay una página de autogestión. Los tokens de API se emiten por usuario y los emite un Admin de esa organización, a través de la propia API:


​

POST /admin/users/{user_id}/api-credentials


​

Leanmote registra cuándo se usó cada token por última vez, así que un Admin puede listar los tokens de un usuario y ver cuáles siguen en uso antes de revocar nada.


​

Qué puedes leer


​

La REST API está organizada alrededor de los mismos objetos que ves en el producto:


​

  • Organizaciones — la organización, sus miembros, sus equipos y sus aplicaciones conectadas.

  • Equipos — un equipo, sus miembros, sus responsables, sus tareas y sus interacciones. Los equipos se pueden crear y editar, y se pueden agregar o quitar miembros.

  • Usuarios — un usuario, los equipos a los que pertenece, las herramientas a las que está mapeado y sus vistas guardadas. GET /users/me resuelve a quién pertenece la credencial.

  • Trabajo — boards y sus tareas, más las interacciones (commits, pull requests, revisiones, comentarios) que Leanmote ingirió.

  • Calendarios — calendarios conectados y sus eventos.

  • Vistas guardadas — las vistas de dashboard y los filtros personalizados que tiene configurados una organización, incluido el catálogo de lo que se puede armar.

  • Reglas de alerta — crearlas, editarlas y deshabilitarlas.

  • Organigrama — la jerarquía de equipos ya resuelta, más el flujo de importación que propone una jerarquía a partir de los nombres de los equipos y te deja aplicarla o deshacerla.


​

GET /health responde sin credencial, así que es el destino correcto para una prueba de conectividad.


​

Casos de uso habituales


​

  • Embeber métricas en tus propios dashboards — lee de la Metrics API y renderiza en la herramienta de datos que ya uses.

  • Automatizar el ciclo de vida de los usuarios — apunta tu proveedor de identidad a SCIM para crear, actualizar y desactivar usuarios.

  • Enviar telemetría de herramientas de IA — usa el endpoint de OTLP para Claude Code y otras herramientas instrumentadas.

  • Armar una integración propia — combina la REST API y la Metrics API para llevar los datos de Leanmote a herramientas internas.


​

Artículos relacionados


​

  • Panorama de integraciones

  • SSO y SCIM

  • Integración con Claude Code (OTLP)

¿Ha quedado contestada tu pregunta?