Saltar al contenido principal

Webhooks

Endpoints que reciben los eventos del workspace, firmados. test envía un evento test.webhook en el acto, rotate-secret cambia el secreto de firma, y deliveries get / deliveries retry listan y reenvían las entregas de un endpoint.

ComandoHTTPDescripción
webhooks listGET /v1/webhooksListar endpoints de webhook
webhooks createPOST /v1/webhooksCrear endpoint de webhook
webhooks getGET /v1/webhooks/{id}Consultar endpoint de webhook
webhooks updatePATCH /v1/webhooks/{id}Actualizar endpoint de webhook
webhooks deleteDELETE /v1/webhooks/{id}Eliminar endpoint de webhook
webhooks rotate-secretPOST /v1/webhooks/{id}/rotate_secretRotar el secreto del webhook
webhooks testPOST /v1/webhooks/{id}/testEnviar webhook de prueba
webhooks deliveries retryPOST /v1/webhooks/{id}/deliveries/{delivery_id}/retryReintentar entrega de webhook
webhooks deliveries listGET /v1/webhooks/{id}/deliveriesListar entregas de un webhook

Ejemplos​

--params lleva parámetros de query, de ruta y de encabezado (id, página, filtros, X-Workspace-Id); --json lleva el cuerpo de la solicitud; --fields limita los campos que vuelven — vale la pena en todo list/get, para ahorrar contexto. Mira Flags globales para la referencia completa.

# Listar endpoints de webhook
kobana dashboards webhooks list --fields "id,url,active,events"

# Crear endpoint de webhook
kobana dashboards webhooks create \
--json '{"url": "https://example.com/webhooks", "events": ["portal_user.invited", "portal_user.updated"]}'

# Enviar webhook de prueba
kobana dashboards webhooks test --params '{"id": "WEBHOOK_ID"}'

# Listar entregas de un webhook
kobana dashboards webhooks deliveries list \
--params '{"id": "WEBHOOK_ID", "status": "failed"}'

# Reintentar entrega de webhook
kobana dashboards webhooks deliveries retry \
--params '{"id": "WEBHOOK_ID", "delivery_id": "DELIVERY_ID"}'

Próximos pasos​