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) |
Parámetros
Sección titulada «Parámetros»| 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. |
Ejemplo
Sección titulada «Ejemplo»Contra el sandbox, con una clave onx_test_…:
curl -X DELETE "https://api-sandbox.opennexum.com/v1/conecta/webhooks/whk_8f2c1a7d9e" \ -H "Authorization: Bearer onx_test_…"Respuestas
Sección titulada «Respuestas»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.
Errores
Sección titulada «Errores»Cada código tiene su explicación en Errores.
- 400
validacion - 401
clave_invalida - 403
permiso_faltante - 404
no_encontrado - 429
limite_uso - 500
error_interno - 501
operacion_no_disponible - 503
no_disponible