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.
| Comando | HTTP | Descripción |
|---|---|---|
webhooks list | GET /v1/webhooks | Listar endpoints de webhook |
webhooks create | POST /v1/webhooks | Crear endpoint de webhook |
webhooks get | GET /v1/webhooks/{id} | Consultar endpoint de webhook |
webhooks update | PATCH /v1/webhooks/{id} | Actualizar endpoint de webhook |
webhooks delete | DELETE /v1/webhooks/{id} | Eliminar endpoint de webhook |
webhooks rotate-secret | POST /v1/webhooks/{id}/rotate_secret | Rotar el secreto del webhook |
webhooks test | POST /v1/webhooks/{id}/test | Enviar webhook de prueba |
webhooks deliveries retry | POST /v1/webhooks/{id}/deliveries/{delivery_id}/retry | Reintentar entrega de webhook |
webhooks deliveries list | GET /v1/webhooks/{id}/deliveries | Listar 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
- Entregas de webhook
- Eventos
- Introspección de schema — todos los parámetros que acepta este recurso.