Introducción a la API para mentores

La API para mentores es una API REST que te permite gestionar tus productos de Grou desde fuera del Hub: tu propia plataforma, una automatización o un agente de IA (a través de nuestro MCP).

Con ella puedes recorrer el ciclo completo de un producto: crear un borrador → editarlo → subir la imagen → publicarlo (obteniendo el link de pago) y, cuando quieras, despublicarlo. Todo lo que hagas por la API aparece en tu Hub exactamente igual que si lo hubieras hecho a mano.

URL base

https://hub.grou.com/api/ext

Todas las rutas de esta documentación son relativas a esta URL. Cada request se autentica con tu API Key (ver Autenticación).

Qué puedes gestionar

Además hay rutas de apoyo:

• GET /me — confirma a qué cuenta pertenece tu API Key.
• GET /reference/{kind} — valores válidos (categorías, monedas, proveedores de video…). Ver Datos de referencia.
• GET /{tipo} — lista tus productos. Ver Mi catálogo.

Estados de un producto

Todos los recursos usan los mismos tres estados públicos:

Flujo típico

1. POST /programs (o /workshops, /external) → crea el borrador.
2. POST /programs/{id}/images → sube la miniatura.
3. POST /programs/{id}/publish → publica y recibe el checkout_url.
4. Opcional: POST /checkouts para armar una página de venta con varios productos.

El objeto Resource

Casi todas las respuestas devuelven un Resource con la misma forma:

{
  "id": "6ab8...f001",
  "type": "program",
  "external_ref": "mi-plataforma-diplomado-42",
  "state": "published",
  "version_id": "6ab8...v001",
  "checkout_url": "https://<dominio-de-checkout>/v2/6ab8...f990",
  "created_at": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-01T00:00:00Z"
}

• external_ref es un identificador tuyo (opcional) que puedes mandar al crear. Te sirve para encontrar el producto después sin haber guardado nuestro id.
• En programas y talleres, GET, crear y editar también devuelven el árbol content con el id de cada módulo, lección o sesión.

Contenido de esta guía

• Autenticación (API Key)
• Programas · Programas externos · Talleres · Checkouts
• Imágenes
• Configuración comercial
• Ciclo de vida y versiones
• Mi catálogo (listar y buscar)
• Datos de referencia
• Errores