Eliminar un webhook

DELETE/v1/webhooks/{id}

Para desarrolladores

Descripción

Elimina un webhook. Deja de recibir entregas y sus reintentos pendientes se descartan.

Autenticación

Authorizationbearer tokenheaderobligatorio

API key con scope webhooks:write. Formato: Bearer <API_KEY>.

X-Instance-Slugstringheaderobligatorio

Identificador de su instancia. Ver Autenticación.

Request

Path params:

idintegerobligatorio

Identificador del webhook.

Response

204 No ContentEl webhook queda eliminado; la respuesta no trae body.

Errores

Código	Cuándo
404	El webhook no existe en la instancia (webhook_not_found).

Detalle completo en Errores genéricos.

Notas

• La eliminación es definitiva. Para detener las entregas por un tiempo, pause el webhook con is_active: false en PATCH /v1/webhooks/{id}.
• Un webhook eliminado deja de contar para el cupo del plan.

Request

curl -X DELETE "https://$API_HOST/v1/webhooks/3" \
-H "Authorization: Bearer $API_KEY" \
-H "X-Instance-Slug: $SLUG"

Response

Sin cuerpo: la respuesta no trae contenido.