Programas

Publicar un programa

Valida el borrador, lo pone a la venta y devuelve el checkout_url. Si falta algo, responde 422 indicando qué. Publicar un programa que ya está en vivo y sin cambios pendientes no hace nada y devuelve el mismo checkout_url. También sirve para volver a publicar uno despublicado.

POST

/programs/{id}/publish

curl --request POST \
  --url https://hub.grou.com/api/ext/programs/{id}/publish \
  --header 'Authorization: Bearer <token>'

{
  "checkout_url": "https://checkout.example.com/v2/6ab8c1f0a1b2c3d4e5f6f990",
  "created_at": "2026-01-01T00:00:00.000Z",
  "external_ref": "mi-plataforma-diplomado-42",
  "id": "6ab8c1f0a1b2c3d4e5f6f001",
  "state": "published",
  "type": "program",
  "updated_at": "2026-01-02T00:00:00.000Z",
  "version_id": "6ab8c1f0a1b2c3d4e5f6a002"
}

curl -X POST https://hub.grou.com/api/ext/programs/$PROGRAM_ID/publish \
  -H "Authorization: Bearer $GROU_API_KEY"

La respuesta trae el checkout_url para compartir con tus compradores.

Autorizaciones

Authorizationstringheaderobligatorio

Tu API Key del Hub (Configuración → API Keys), que empieza por sk_. Solo se muestra una vez al generarla.

Parámetros de ruta

idstringobligatorio

El id del recurso, tal como lo devolvió la API.

Respuesta

Programa publicado.

checkout_urlstring | nullobligatorio

Link de pago. Solo cuando el recurso está published.

created_atstringobligatorio

external_refstring | null

Tu identificador, si lo enviaste al crear.

idstringobligatorio

stateenum<string>obligatorio

draft: borrador, no visible para compradores. published: a la venta, con checkout_url. unpublished: retirado de la venta, se puede volver a publicar.

Opciones disponibles: draft, published, unpublished

typeenum<string>obligatorio

Opciones disponibles: program, external, workshop, checkout

updated_atstringobligatorio

version_idstring | null

Versión actual. Siempre null en checkouts.

¿Aún necesitas ayuda? Comparte una idea