DELETE /v1/webhooks/{id}

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 FD.<key_id>.<token>.

X-Instance-Slugstringheaderobligatorio

Request

Path params:

idinteger

Identificador del webhook.

Response

204 No Content, sin 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, se pausa el webhook con is_active: false.
• 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

{
"type": "https://docs.fidelizador.com/errors/unauthorized",
"title": "Unauthorized",
"status": 401,
"detail": "Authentication required.",
"code": "unauthorized",
"trace_id": "4d9f8c2b1a7e6f3d5c8b0a9e7d6c5b4a"
}