Ir al contenido principal
API para mentores

Talleres

Crea talleres (cohortes) con fechas, zona horaria y sesiones en vivo.

Escrito por Jacobo

Última actualización Hace 23 días

Un taller es una cohorte con fecha de inicio y fin y sesiones en vivo agrupadas en módulos.

MétodoRutaQué hace
POST/workshopsCrea un borrador
GET/workshopsLista tus talleres
GET/workshops/{id}Devuelve el taller, su estado y su contenido
PATCH/workshops/{id}Edita el borrador (o abre uno nuevo si ya está publicado)
POST/workshops/{id}/imagesSube la miniatura
POST/workshops/{id}/publishPublica y genera el checkout_url
POST/workshops/{id}/unpublishLo retira de la venta
GET/workshops/{id}/versionsHistorial de versiones

Body

CampoRequeridoDescripción
external_refNoTu identificador para este taller
general.nameSíNombre
general.descriptionNoDescripción
general.category_idsNoIds de categorías (principal / subcategoria)
content.start_dateSíInicio (ISO 8601, ej. 2026-03-01T00:00:00Z)
content.end_dateSíFin (ISO 8601)
content.timezoneSíZona horaria IANA, ej. America/Bogota
content.modules[]Para publicarMódulos: name (máx. 200) y sessions[] (al menos una)
content.modules[].sessions[]Para publicartitle (máx. 150), date (YYYY-MM-DD), time (HH:mm), description (máx. 350), link
content.slotsNoCupos de la cohorte (entero ≥ 1)
content.previous_sessionsNoLink o notas de una cohorte anterior
content.what_you_will_learnPara publicarLista de "Lo que aprenderás" (al menos 1)
content.target_audiencePara publicarLista de "Para quién es" (al menos 1)
content.faqsPara publicarLista de { question, answer } (al menos 1)
commercialNoPrecios, cuotas o suscripciones
coproductionNoLista de { mentor_id, percentage }

Puedes crear el borrador incompleto; los campos marcados "Para publicar" se validan al publicar.

Al editar (PATCH) se envía el body completo, igual que al crear: general.name, content.start_date, content.end_date y content.timezone siempre son obligatorios.

Ejemplo — crear un borrador

POST /api/ext/workshops
Authorization: Bearer sk_<tu-api-key>
Content-Type: application/json

{
  "external_ref": "mi-plataforma-bootcamp-3",
  "general": { "name": "Bootcamp de Ventas — Cohorte 1" },
  "content": {
    "start_date": "2026-03-01T00:00:00Z",
    "end_date": "2026-03-31T00:00:00Z",
    "timezone": "America/Bogota",
    "slots": 30,
    "what_you_will_learn": ["Cerrar ventas por WhatsApp"],
    "target_audience": ["Emprendedores que venden online"],
    "faqs": [{ "question": "¿Quedan grabadas las sesiones?", "answer": "Sí." }],
    "modules": [
      {
        "name": "Semana 1",
        "sessions": [
          {
            "title": "Sesión en vivo 1",
            "description": "Kickoff",
            "date": "2026-03-01",
            "time": "18:00",
            "link": "https://meet.example.com/s1"
          }
        ]
      }
    ]
  },
  "commercial": {
    "base_currency": "USD",
    "pricing": [{ "currency": "USD", "value": 299.0 }]
  }
}

Respuesta 201 Created: un Resource con type: "workshop", state: "draft" y el árbol content con los id de cada módulo y sesión.

Despublicar un taller

Al despublicar, la API reporta state: "unpublished", pero en el Hub el taller aparece como Borrador (los talleres no tienen un estado "despublicado" propio). Se puede editar y volver a publicar, y conserva su historial.

¿Fue útil esto?

¿Aún necesitas ayuda? Comparte una idea