Delete an endpoint

Permanently delete a webhook endpoint and its delivery history.

DELETE{BASE_URL}/webhooks/{id}

Deletes the endpoint permanently, with its delivery history. Deliveries still waiting to be retried are not sent. Requires a provider key; the partner header is ignored.

To stop deliveries for a while instead, update the endpoint's status to DISABLED.

Path parameters

idstringrequired: The endpoint's ID.

The response has no data.

Status codes#

Status	Code	Meaning
`200`	—	Deleted.
`403`	`provider_key_required`	A partner key made the call.
`404`	`webhook_endpoint_not_found`	You have no endpoint with that ID — including one you already deleted.

curl -X DELETE "$LOCALOY_BASE_URL/webhooks/cm8wh00k0000000000000002" \
  -H "Authorization: Bearer $LOCALOY_PROVIDER_KEY"

Response · 200

{
  "success": true,
  "message": "Webhook endpoint deleted. Its delivery history was removed with it."
}