Ir al contenido

Beta privada · apertura 23 de diciembre

Borra un webhook

DELETE /v1/conecta/webhooks/{id}

Deja de enviar eventos a ese endpoint y cancela las entregas pendientes. Según tu clave, puede esperar la aprobación de una persona.

Dato Valor
Permiso webhooks:administrar
Cobro No cobra.
Idempotency-Key No aplica
Aprobación humana Según la configuración de tu clave puede responder 202 requiere_confirmacion.
Herramienta MCP webhook_borrar (Próximamente)
Nombre En Requerido Tipo Descripción
id path Sí string Identificador que empieza con whk_.
X-Request-Id header No string Identificador de la petición. Va en cada respuesta; menciónalo al escribir a soporte.

Contra el sandbox, con una clave onx_test_…:

Ventana de terminal
curl -X DELETE "https://api-sandbox.opennexum.com/v1/conecta/webhooks/whk_8f2c1a7d9e" \
-H "Authorization: Bearer onx_test_…"

Espera la aprobación de una persona.

Campo Tipo Requerido Descripción
estado “requiere_confirmacion” Sí
operacion_id string Sí Úsalo en GET /v1/confirmaciones/{id} para saber si se aprobó.
confirmacion_url string (uri) Sí Enlace del panel donde una persona aprueba o rechaza. Pásaselo tal cual.
consulta_url string Sí Ruta para consultar el estado.
expira_en string (date-time) Sí Antes de esta hora hay que aprobarla Y repetir la petición; si no, vence y no se hace.
mensaje string Sí Qué falta, en palabras para una persona.

Webhook borrado.

Cada código tiene su explicación en Errores.